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OPERATING 
INFORMATION 



GENERAL 

This chapter provides a general overview of how the VT125 operates, and 
a description of the terminal's controls and indicators. This chapter also 
provides a summary of basic operating procedures. Detailed operating in- 
formation depends on the computer and the software to which the termi- 



TERMINAL OPERATION 

The VT125 Graphic Terminal (Figure i-1) is a VT100 video text terminal 
and a graphics processor in one package. The graphics processor pro- 
cesses graphic commands from a computer to generate an image in its 




Figure 1-1 VT125 Graphics Terminal 
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INTRODUCTION 



PRODUCT INTRODUCTION 

The VT125 is a graphics display terminal that combines a bit map archi- 
tecture with the alphanumeric capability of the VT100 video terminal. The 
VT125 is a smart terminal that directly executes DIGITAL'S general pur- 
pose graphics descriptor - Remote Graphics Instruction Set (ReGIS). 
ReGiS iets you create and store pictures as ASCii text and efficiently 
send those pictures to remote displays. The VT125 also has an auxiliary 
data port for making hard copies of the display with the DECwriter IV 
Graphic Printer. The VT125 includes a VT105 emulator for users who have 
programs for the older VT105. 

BOOK INTRODUCTION 

Thio hnnU- Hocrrihoc tho fniinu/inn nrnHiir+c 1 

VT125-AA and -AB Graphics Terminal and 

VT1XX-CB and -CL Graphics Processors for VT100 and VT105. 

This User Guide provides general operating information, interface infor- 
mation, control functions and ReGIS command descriptions, and specific 
installation and checkout procedures. The main audiences for this docu- 
ment are the operator, applications programmer, and terminal installer. 
The operator, however, should use this book only as a reference when op- 
erating the terminal. The document that describes use of application soft- 
ware is the primary document for the operator. 

Information in this User Guide is divided by function. Refer to a specific 
chapter according to the function to be performed. The chapters are ar- 
ranged by frequency of use. Since operating information is frequently 
used, it is at the beginning. Installation is performed only once, so it is 
placed toward the end of the book. 

This document is written for three types of readers: 

1. The operator, needing general operating information (Chapters 1, 2, 
3, 9, and 11) 
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2. The applications programmer, needing ReGIS, VT105, control func- 
tions, and communications descriptions (Chapters 4, 5, 6, and 7), 
and 

3. The hardware installer, needing specific installation and checkout in- 
formation (Chapters 8, 9, 10, and 11). 

Chapter 1 provides a general introduction on how the terminal operates. It 
also shows all the terminal controls and indicators. This chapter summa- 
rizes basic terminal operation. Detailed operating information may depend 
on the computer software. 

Chapter 2 defines SET-UP and describes each SET-UP feature in detail. 
Many of the terminal's SET-UP features change how the terminal commu- 
nicates with the computer. Detailed information on communication and re- 
lated SET-UP features is provided in the Communication chapter. 

Chapter 3 describes the characters and codes transmitted by the termi- 
nal, and shows the keys required to produce the codes. 

Chapter 4 explains to the programmer the use of control functions to con- 
trol the display, processing, transmission, and representation of charac- 
ters by the terminal. The chapter includes a description of the characters 
received by the terminal. 

Chapter 5 provides the syntax and commands of the ReGIS graphics de- 
scriptor. 

Chapter 6 provides the syntax and commands of the VT105 emulator. 

Chapter 7 describes the types of communication interfaces available on 
the VT125. This chapter also describes the methods of communicating 
with the graphics option, computer and printer, and describes the SET-UP 
features used with these devices. 

Chapter 8 describes the environmental conditions to be considered before 
installing the terminal. A detailed installation procedure is provided. This 
chapter also has a step-by-step procedure for turning on the terminal and 
checking that it operates correctly. 

Chapter 9 describes all operator maintenance procedures used with the 
VT125. Self-test information is also provided. This information outlines the 
steps needed to start the built-in tests and to understand the results once 
the tests have run. This chapter also has a general procedure for oper- 
ator troubleshooting of the terminal. 

Chapter 10 describes the VT125 options: the Advanced Video option and 
current loop interface adapter, and the VT1XX-CB and -CL Graphics Pro- 
cessor upgrades for the VT100 and VT105. It also provides installation 
and checkout instructions. 
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Chapter 1 1 describes accessories and supplies for the VT125. This chap- 
ter includes a short description of each accessory and supply, its part 
number, and ordering information. 

Appendix A lists the specifications of the VT125 terminal. 

Appendix B provides a summary of the SET-UP feature display. 

Appendix C lists the character codes generated by the VT125 terminal. 

Appendix D provides a summary of the VT125 control functions and 
ReGIS commands. 

Appendix E describes the ANSI code extension techniques used to create 
escape and control sequences. 

Appendix F describes how to write ReGIS commands for both the VT125 

ClIIVJ UIC Vl\ IUU. 

Appendix G explains the HLS color system in the VT125. 

Appendix H lists the ReGIS commands used to create art for this book. 

Glossary provides a list of technical words and their definitions. 

Other Terminals provides a description of terminals offered by DIGITAL. 

Index provides a list of words with page numbers indicating where the top- 
ic may be found. 

Warranty Information describes the warranty and services available from 
DIGITAL. 

BOOK METHODS 

This book uses colored shading to indicate tables, and gray shading to 
indicate procedures. The part of a figure being discussed is in color. 

NOTES, CAUTIONS, AND WARNINGS 

A note contains information important enough to set off from the main 
body of text. A caution contains information essential to the safety of 
equipment and software. A warning contains information essential to the 
safety of personnel. 
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own memory. Then it sends a video representation of that image to the 

VT100 tO.Xt termfOgl'S intprppj monitor epropn pr>H +r> or> /->r>+ior»Q! ov + orr*o! 

color monitor. It can also send a bit map representation of the image to a 
graphic printer. If data coming to the VT125 are not graphic commands or 
other commands to the graphics processor, the graphics processor 
sends the data to the VT100. The VT100 then displays text data and pro- 
cesses control functions data. 

CONTROLS AND INDICATORS 

The VT125 video terminal controls and indicators are explained in four 
groups: 

1. Monitor controls, 

2. Keyboard controls, 

3. Visual indicators, and 

4. Audible indicators. 

Monitor Controls 

The VT125 terminal has two controls on the rear panel. The controls are 
the ac voltage selection switch and the ac power ON /OFF switch (Figure 
1-2). 
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Figure 1-2 Monitor Controls and Connector Locations 
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AC Voltage Selection Switch - This switch lets the VT125 terminal oper- 
ate with available ac input voltage. Refer to Installation (Chapter 8) for 
more information. 

CAUTION: Setting the ac voltage selection switch to 120 Vac when us- 
ing 198 to 256 Vac power source will damage the terminal. 

NOTE: The ac voltage selection switch does not select the ac line fre- 
quency power SET-UP feature. Refer to the SET-UP chapter (Chapter 2) 
for more information. 

AC Power ON/OFF Switch - This switch turns the ac power to the termi- 
nal on and off. Either the ON LINE or LOCAL keyboard indicators light to 
show the ac power ON condition. Refer to the indicators section of this 
chapter for more information on VT125 indicators. 



A power-up self-test verifies proper operation of the VT125 terminal each 

III 11^ II I ^ IOI llllliai IO pUV»CIV/U K4 

up and checkout the terminal. 
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1. Turn the power switch to the ON position (refer to Figure 1-2 for the 
switch location). The terminal automatically runs the power-up self- 
test. The test gives the following indications: 

a. Keyboard and screen flash on and off. 

b. All keyboard indicators turn on and off, and either the ON LINE or 
LOCAL indicator is turned on. 

c. The wait message is displayed on the screen and then is erased. 

d. A bell tone sounds. 

e. A band of light appears at the top of the screen and is erased. 

f. Another bell tone sounds. 

g. A message appears to announce the result of the VT125 self-test, 
and a box is drawn* around the margins of the graphics screen 
area. (This message stays on the screen until the first character 
arrives over the communication line.) 

NOTE: No message appears on the screen until the terminal 
warms up. 



*Not on all units 



4 OPERATING INFORMATION 



h. The text cursor is displayed in the upper-left corner of the screen. 

Any error found by the power-up self-test is displayed on the 
screen as either a character, a message, on keyboard indicators 
L1-L4, or by several bell tones. Refer to the Self-Test Error Codes 
section of Chapter 9 for more information on error indications. 

2. If the terminal powers up correctly, select the SET-UP features you 
want as described in Chapter 2. 

Keyboard Controls 

The VT125 has a typewriter-styled main keyboard and calculator-styled 
auxiliary keypad. The main keyboard is arranged and operates similar to a 
standard office typewriter. The auxiliary keypad allows rapid entry of nu- 
meric data or function characters. 

Some keys generate one or more characters immediately when typed. 
Other keys, such as CTRL and SHIFT, do not generate characters when 
typed, but modify characters generated by other keys. If two character- 
generating keys are pressed almost at the same time, they might be down 
at the same time. However, the two characters are generated according 
to the order in which the keys were typed. The VT125 does not wait for 
the keys to be lifted, but generates both characters as soon as possible 
after the keys are typed. If three character-generating keys are pressed 
at the same time, the characters from the first two keys are generated 
immediately. The character for the third key is generated when one of the 
first keys is lifted. 

The keyboard keys are divided by function: 

Standard keys, 
Function keys, 
Auxiliary keypad keys, and 
SET-UP keys. 
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Figure 1-3 Standard Keys 



Standard Keys = Figure 1-3 identifies keys labeled as standard type- 
writer and calculator keys. The codes transmitted by each of these keys 
under various conditions are described in the Transmitted Characters 
chapter (Chapter 3). 

Also, some of the standard typewriter and calculator keys, when used as 
function keys, may generate control characters. Figure 3-3 shows the 
control character generated by each key. Refer to the computer software 
user guide for the meaning of the keys. 




CAPS LOCK 

When pressed before pressing alphabetic keys, this key generates up- 
percase alphabetic characters, regardless of the position of the SHIFT 
key. The CAPS LOCK key locks into position during operation. To release 
this key, press it again. 

The CAPS LOCK key has no effect on numeric keys, special symbol keys 
and the auxiliary keypad. 



^^^■^H SHIFT 

When pressed in combination with other keys, these keys generate up- 
percase characters for the alphabetic, numeric, and special symbol keys 
of the main keyboard. The SHIFT key does not affect the auxiliary keypad 
keys or TAB, RETURN, LINEFEED, BACKSPACE, DELETE, or space bar 
(unlabeled). 

Function Keys - Figure 1-4 identifies the function keys of the VT125. The 
following paragraphs provide general descriptions of these keys. 




ESCAPE 

This key generates the escape character. 
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Figure 1-4 Function Keys 




TAB 

This key generates the tab character. 




CONTROL 

When pressed in combination with another key, the CTRL key generates 
control characters. Figure 3-3 in Chapter 3 shows which key to press for 
each control character. 




DELETE 

This key generates a delete character. The deleted character may or may 
not be erased from the screen depending on the computer's software. 




RETURN 

This key generates either a carriage return (CR) or a carriage return and 
linefeed (CRLF). The characters generated are selected using the Line- 
feed/New Line SET-UP feature. Refer to the SET-UP chapter (Chapter 2) 
for more details on this SET-UP feature. 




LINE 
FEED 

This key generates a linefeed character. 




OPERATING INFORMATION 7 



NO 
SCROLL 

This key stops the VT100 from processing characters when first pressed 
during character transmission from the computer through the graphics 
processor to the VT125. The contents of the text display is held in place 
and scrolling stops. Other activities, such as graphics processing or print- 
ing, may continue. When the NO SCROLL key is pressed a second time, 
the VT100 continues processing characters, the screen displays the new 
characters, and scrolling continues. 



i^H BACKSPACE 

The backspace key transmits the backspace character. 




This key generates a Break signal. Refer to the Communication chapter 
(Chapter 7) for details on the use of the Break signal. The computer re- 
sponse to the Break signal depends on the computer and software. Refer 
to the computer software user guide for details on the use of this key. 

When pressed while pressing the SHIFT key, the BREAK key causes a 
long break disconnect. Refer to the Communication chapter (Chapter 7) 
for details on long break disconnects. 

When pressed while pressing the CTRL key, the BREAK key causes the 
VT100 answerback message to be transmitted. Refer to the SET-UP chap- 
ter (Chapter 2) for more details on the answerback message. 




Cursor Control Keys 

These keys usually generate cursor control commands. The cursor is an 
indicator on the video screen that shows the line and column where the 
next character will be positioned. Each of these keys generates charac- 
ters that may have a special meaning to the computer. Refer to the com- 
puter software user guide for details on the use of these keys. 

Auxiliary Keypad 

These keys let you enter numbers quickly as with a calculator. The minus, 
comma, period, and numeric keys of the auxiliary keypad usually gener- 
ate the same characters as the corresponding unshifted keys of the main 
keyboard. The ENTER key corresponds to the RETURN key of the main 
keyboard. 
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SET/ CLEAR ALL LINE/ SETUP TOGGLE TRANSMIT RECEIVE 80/132 

CLEAR TAB TABS LOCAL A/B I/O SPEED SPEED COLUMNS RESET 



Figure 1-5 SET-UP Keys 



The auxiliary keypad can be used in two ways, depending on your com- 
puter software: 

1. For entering numbers (only PF1, PF2, PF3, PF4 are function keys), 
or 

2. For special purposes such as video editors (all keys are function 
keys). 

Refer to Chapter 3 for an explanation of the different keypad function 
keys. Refer to the computer software user guide for more information on 
the use of these keys. 

SET-UP Keys - Figure 1-5 shows the keys that have meaning to the 
VT125 when operating in SET-UP. There are two SET-UP displays: SET- 
UP A, and SET-UP B. The SET-UP chapter (Chapter 2) has a detailed ex- 
planation of the use of these keys. 




SET-UP 

This key places the VT125 in SET-UP. Terminal features can be changed 
while in SET-UP. Entering and exiting SET-UP also cancels any ReGIS 
hardcopy command. 




SET/CLEAR TAB 

In SET-UP A this key sets or clears single horizontal tabs. In SET-UP B this 
key is inactive. 




CLEAR ALL TABS 

In SET-UP A this key clears all horizontal tabs set. In SET-UP B this key is 
inactive. 
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LINE/LOCAL 

In any SET-UP display this key switches the VT125 between ON-LINE and 
LOCAL. While ON-LINE the VT125 communicates with the computer 
through the graphics option. While LOCAL the VT125 cannot commu- 
nicate with the computer. Instead, the VT100 terminal inside the VT125 
communicates only with itself, ignoring the graphics option. However, the 
graphics option can continue to process data from the computer. Use a 
data loopback connector with the terminal ON-LINE to communicate with 
the graphics option from the keyboard. Refer to the Maintenance and 
Troubleshooting chapter (Chapter 9) for instructions. 




SET-UP A/B 

In SET-UP this key switches the VT125 between SET-UP A and SET-UP B. 




TOGGLE 1/0 

In SET-UP B this key turns the selected feature on or off. In SET-UP A this 
key is inactive. 




TRANSMIT SPEED 

In SET-UP B this key steps the VT125 up through the transmit baud rate 
settings of the line to the computer. In SET-UP A this key is inactive. 




RECEIVE SPEED 

In SET-UP B this key steps the VT125 through the receive baud rate set- 
tings of the line to the computer. In SET-UP A this key is inactive. 




80/132 COLUMNS 

In SET-UP A this key switches the display line size between 80 and 132 
characters per line. In SET-UP B this key is inactive. 




RESET 

In any SET-UP display this key starts the reset sequence. This has the 
same result as turning the VT125 power off and then on. 

NOTE: The reset sequence erases the VT125 memory. This includes the 
text and graphics display data, any temporarily stored SET-UP feature 
settings, and any selected graphics protocols. 
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^HIH Cursor Keys 

In any SET-UP display these keys increase and decrease the brightness 

of the display. 




Cursor Keys 

In any SET-UP display these keys move the cursor left and right. 




A 

In SET-UP B, while pressing the SHIFT key press the A key to enter the 
answerback message in the VT125. 




R 

In any of the SET-UP displays, while pressing the SHIFT key, press the R 
key to recall the previously stored user permanent memory SET-UP fea- 
ture selections. 




S 

In any of the SET-UP displays, while pressing the SHIFT key, press the S 
key to store the current SET-UP feature selections in the user permanent 
memory. Refer to the SET-UP chapter (Chapter 2) for more details. 

Visual Indicators 

Figure 1-6 shows the location of the visual indicators. The following para- 
graphs describe the function of each indicator. 

ON LINE - When this indicator is on, the text terminal is on-line and ready 
to transmit or receive data. When ac power is ON, either the ON LINE or 
LOCAL indicator is on. 

LOCAL - When this indicator is on, the text terminal is local and cannot 
communicate with the computer or the graphics option. When the text ter- 
minal is local, it displays data entered from the keyboard on the screen as 
if the data came from the computer. When ac power is on, either the ON 
LINE or LOCAL indicator is on. LOCAL shouid only be used to test the text 
terminal. Always leave the terminal on-line. 

KBD LOCKED - When this indicator is on, the keyboard has been turned 
off (locked) either by the computer or by the terminal itself. Any new char- 
acters typed are lost. The terminal can still receive data from the com- 
puter. 
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L2 L3 



ON LINE LOCAL LOCKED 

o o o o o o 



Figure 1-6 Keyboard Indicators 



The computer turns off the keyboard if it cannot process characters as 
fast as the terminal sends them. The computer turns the keyboard on 
when it is ready for more characters. 

The terminal turns off the keyboard if the transmit baud rate is too slow to 
send characters as fast as you type them. The terminal turns the key- 
board on after it sends the characters you already typed. 

NOTE: If you enter and exit SET-UP while the keyboard is locked, char- 
acters already typed are lost and the keyboard is unlocked. However, if 
the computer is not ready to receive characters, characters typed after 
unlocking may be lost. 

L1 - L4 - These indicators are turned on and off by the computer. Refer 
to your computer software instructions for the meaning of each indicator. 
L1 - L4 also show self-test errors. 



Audible Indicators 

There are three audible indicators in the VT125 - a keyclick, a long tone 
(beep), and a series of long tones. 

Keyclick - The terminal generates a keyclick when a key is pressed, with 
the following exceptions. 

• SHIFT or CTRL keys do not generate keyclick because these keys 
do not transmit characters but only modify the characters trans- 
mitted by other keys. 

• KBD LOCKED indicator is on; any keys typed are lost. 

• The keyclick feature is off in SET-UP B. 
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Long Tone (Beep) - The terminal generates a beep to indicate one of the 

• A bell character was received from the computer. 

• The cursor is eight characters away from the right margin and the 
margin bell feature is enabled. 

Series of Long Tones - The terminal generates the long tone many times 
in a row and the screen displays "2" to indicate that the user permanent 
memory cannot read or write the SET-UP features. If this happens, check 
the SET-UP features and then perform the save or recall operation again. 
Service may be needed. Refer to the Maintenance and Troubleshooting 
chapter (Chapter 9). 



I 



SET-UP FEATURES 



GENERAL 

The VT125 terminal has many features in SET-UP that allow the terminal 
to be configured for specific applications. This chapter describes SET-UP 
gnH gach of the SET- UP features. 



SCTJ ID (nnti irno nkonno ktssttj tl-io \/T lOK torminal nnprafoc Thou a I In \ A/ tho 

terminal to be configured to operator preference, and they provide com- 
patibility to the computer and ac power source. Table 2-1 divides the SET- 
UP features into three general types: operator preference, communication 
compatibility, and installation. 

Operator Preference 

These features configure the terminal to operator preference. They do not 
affect information transferred between the terminal and the computer. 

Communication Compatibility 

These features configure the terminal so that it is compatible with a com- 
puter. There are many combinations of SET-UP features used when com- 
municating with a computer. The features must be selected correctly for 
the terminal to communicate with the computer. An error in these selec- 
tions may stop communication or cause incorrect information to be trans- 
ferred between the terminal and computer. 

NOTE: This chapter describes the SET-UP features used to provide 
compatibility. More information about using these SET-UP features is pro- 
vided in the Communications chapter (Chapter 7). 

Installation 

These features configure the terminal for operation in different installa- 
tions. If the location of the terminal is changed, verify these feature selec- 
tions. 
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SET-UP Feature 


Preference 


Compatibility 


Installation 


ON LINE/LOCAL 




siiiiiisiisiii 




Screen brightness 


IliliilSSi 






Columns per line 




iiiiitiiiiSji 




Tab stops 




?lillllfi|i|l§l 




Scroll 


i§SCiill 






Auto repeat 


ItliiiflSI 






Screen background 


iKliliili 






Cursor 


W^IBSMIBIli 






Margin bell 


§f|IfSftli 






Keyclick 


|||§'i:;||g|i|i 






ANSI/VT52 




SSS^SISIiilil 




Auto XON/XOFF 




^||,:lp^i|fl;| 




US/UK character set 






l|||g|ig|l| 


Auto wrap 




; ^&$*0$Wh 




Linefeed/ new line 




v '"#Sy^?S ■?$■"< 




Interlace 






^pxiiffp 1 ;^: 


Parity sense 




/:. : xS^3fSir i: V^ 




Parity 




{:%$%■:■ L}0j^iUl 




Bits per character 




^^^.^^^gjjlil 




Power 






-$MkiM&A-: 


AUX port bits per character 




■■■M^'^T^Mi^V. 




AUX port speed 




iS^if'^t.^^^;! 




Transmit speed 




INIfi€;l!|::lf 'U 




Receive speed 




|^x|i|lliiIl|cSffl;i! 




Answerback 




S^4^.;;;^feS 





FEATURE SELECTION 

SET-UP features can be selected by the computer or from the terminal 
keyboard. When the computer changes the feature selections, the SET- 
UP features are not destroyed. However, the current selection is shown 
by the SET-UP feature display. SET-UP features that can be changed by 
the computer are listed in Table 2-2. Refer to the Received Character Pro- 
cessing chapter (Chapter 4) for more information about computer selec- 
tion of features. 
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Table 2-2 SET-UP Features the Computer Can Change 

SET-UP Feature Can Be Changed 

ON LINE/LOCAL 

Screen brightness 

Columns per line X 

Tab stops X 

liiiiiisiisiiiiiiii 

Auto repeat X 

Screen background X 

Margin bell 

ANSI/VT52 X 

Auto XON/XOFF 

US/UK character sei X 

Aii+r\ utran V 

r\utu «viu^ '« 

Linefeed/new line X 

interlace X 

Parity sense 

Bits per character 

AUX port bits per character 
AUX port speed 
Transmit speed 
Receive speed 
Answerback 
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To select SET-UP features from the keyboard you must enter SET-UP 



SFT-IJP h 



ac tijyn foatura Hicrtlowc- CCT.I ID A a*** OCTJID D /cr:~..-.^ «-» m\ 

The SET-UP A feature display shows the location of tab stops and a visual 
ruler numbers each column of the line. The SET-UP B feature display 
shows the other SET-UP features. Use the following procedure to change 
a SET-UP feature selection. 



Procedure 



Indication /Comments 



Press SET-UP to 
enter SET-UP. 



SET-UP A is displayed on the 
screen. 



Press SETUP A/B to 

select the correct 
SET-UP display. 



The selected SET-UP display shows 
on the screen. 



Change the SET-UP 
feature selection. 



The SET-UP display shows the 
feature selection. 



Store the SET-UP 
features if desired. 



The terminal displays wait and then 
SET-UP A. 



Press SET-UP to exit 
SET-UP. 



NOTE: Entering and exiting SET-UP with KBD LOCKED on clears the 
keyboard locked condition and erases any characters that were typed af- 
ter the keyboard was locked. Entering and exiting SET-UP also cancels 
any ReGIS hardcopy command. 

ENTERING AND EXITING SET-UP 

You can enter SET-UP while either ON-LINE or LOCAL. 



FEATURE MEMORIES 

The SET-UP feature selections are stored in three memories: operating 
(temporary), user permanent, and SET-UP default (Figure 2-2). 
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SET-UP A 

TO EXIT PRESS "SET-UP" 



1 T T T T T T T T T 

1 234567890tHttH^iEIi:i 234567890tl*tl«1^i:t:Ml234567890tt*tl.1»i:&Ii:i 234567390{HgH^Eri: 



SET-UP B 

TO EXIT PRESS "SET-UP" 



I 

i am 2 ma ig «h s| 



T SPEED 9600 R SPEED 9600 



Figure 2-1 SET-UP Displays 
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Figure 2-2 SET-UP Feature Memories 
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Operating Memory 
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terminal. The terminal always operates according to these features. The 
features can be selected at the terminal keyboard or by the computer. In 
SET-UP, the feature selections in the operating memory are shown on the 
screen. Use the following procedure to change the SET-UP feature selec- 
tions stored in memory. 



Procedure 



Indication/Comments 



Press SET-UP to 

enter SET-UP. 



SET-UP A is displayed on the 
screen. 



Press SETUP A/B to 

select the correct 
SET-UP display. 



The selected SET-UP display shows 
on the screen. 



Change the SET-UP 
feature selection. 



The SET-UP display shows the 
feature selection. 



Press SET-UP to exit 
SET-UP. 



The terminal operates according to 
the new SET-UP feature selections 
in operating memory. 



If a recall or reset procedure is performed, or power to the terminal is 
turned off and on, all operating memory SET-UP feature selections are re- 
placed by the SET-UP feature selections in user permanent memory. 



User Permanent Memory 

This memory stores selected SET-UP features permanently. The com- 
puter cannot change SET-UP feature selections in user permanent memo- 
ry. User permanent memory can only be changed by performing a store 
from the terminal keyboard while in SET-UP. Turning power off does not 
affect SET-UP feature selections in this memory. SET-UP features are 
moved between operating memory and user permanent memory by per- 
forming store, recall, or reset procedures. 



SET-UP FEATURES 19 



Store - This procedure stores the operating memory SET-UP feature se- 
lections in user permanent memory. Storing is performed from the termi- 
nal keyboard. The computer itself cannot store SET-UP feature selections 
in user permanent memory. Use the following procedure to store SET-UP 
feature selections in user permanent memory. 



Procedure 



Indication /Comments 



Press SET-UP to 
enter SET-UP. 



SET-UP A is displayed on the 
screen. 



Hold down SHIFT, press 
S, then release both 
keys. 



The terminal displays wait and then 
SET-UP A. 



Press SET-UP to exit 



oci-ur. 



Recall - This procedure recalls the user permanent memory SET-UP fea- 
ture selections into operating memory. All feature selections previously in 
operating memory are erased. Also, the text screen memory is erased. 
Use the following procedure to recall the SET-UP feature selections from 
user permanent memory into operating memory. 



Procedure 



Indication /Comments 



Press SET-UP to 
enter SET-UP. 



SET-UP A is displayed on the 
screen. 



Hold down SHIFT, press 
R, then release both 
keys. 



The terminal displays wait and then 
SET-UP A. 



Press SET-UP to exit 
SET-UP. 



NOTE: Some features selected by the computer may be affected. 
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Reset - This procedure resets the terminal, erases all memories and per- 

lOimo a ocii icbi. riiou, icoci icociiib iiie Ubci pci i ildilei 11 iiiemuiy OC I "Ui" 

feature selections into operating memory. All feature selections pre- 
viously in operating memory are erased. Use the following procedure to 
reset the terminal. 



Procedure 



Indication /Comments 



Press SET-UP to 
enter SET-UP. 



SET-UP A is displayed on the 
screen. 



Press RESET. 



The power-on self-test runs. The 
terminal operates according to the 
SET-UP feature selections in user 
permanent memory. The terminal 
automatically exits SET-UP. 



SET-UP Default Memory 

The VT125 has default SET-UP feature selections for all the VT125 SET- 
UP features. These default selections cannot be changed by the user. 
When a default occurs (usually because of a problem in the user per- 
manent memory), all operating memory SET-UP feature selections change 
to the default selections. The SET-UP features in user permanent memory 
are not changed by a default. Figure 2-3 shows the default SET-UP fea- 
ture selections. 



TABS 


EVERY 


COLUMNS PER LINE 


80 


ON/OFF LINE 


LOCAL 


ANSWERBACK 


NONE 



EVERY 8 COLUMNS STARTING AT 9 



1110 1 



•SCROLL = SMOOTH 
-AUTO REPEAT = ON 
■SCREEN = DARK BACKGROUND 
-CURSOR = BLOCK 



2 10 1 



MARGIN BELL = OFF- 

KEYCLICK = ON - 

ANSI/VT52 = VT52- 

AUTO XON XOFF = ON - 



3 



■ U.S./U.K. CHARACTER SET = U.S. 

•AUTOWRAP=OFF 

-LINE FEED/NEW LINEOFF 

-INTERLACE = OFF 



4 10 



PARITY SENSE = EVEN- 
PARITY = OFF - 
BITS PER CHAR= - 

POWER -60 Hz - 



AUX PORT 

— BITS PER 
CHAR = 7 

— fAUX 

< PORT = 300 
^SPEED 



5 T = 9600 R = 9600 



Figure 2-3 SET-UP Default Feature Selections 
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SET-UP FEATURE DEFINITIONS 

The definitions in this section are arranged by the SET-UP display in which 
they are changed. A general procedure for changing each SET-UP feature 
in the SET-UP display is provided at the beginning of each SET-UP display 
section. For features needing a more detailed procedure, the procedure 
is given with the SET-UP feature description. The first section includes the 
general features changed in either SET-UP A or SET-UP B. 

NOTE: Entering SET-UP and changing features usually does not cause 
the loss of characters in the VT125 text memory. Any action that does 
cause loss is explained. 

General SET-UP Features 

The on-line /local and screen brightness SET-UP features may be 
changed in any SET-UP display. Dedicated keys on the main keyboard se- 
lect thpQP foatnroc: Fnrh foqtiiro Hoer»rintipn inrlnHpc +h#=> eno^ifi^ rhanno 

procedure. 

ii G jjia^ci 

While on-line (the keyboard ON LINE indicator is on) the text terminal 
transfers data to and from the computer through the graphics processor. 

While local (the keyboard LOCAL indicator is on) the text terminal does 
not transfer data to or from the graphics processor. Characters typed on 
the keyboard are echoed to the screen directly. Local should only be used 
to test the text terminal. Always leave the terminal on-line. 

Use the following procedure to select the on-line or local condition. 



Procedure Indication /Comments 

Press SET-UP to SET-UP A is displayed on the 

enter SET-UP. screen. 

to select on-line keyboard indicators show the 

or local. feature selection. 

Press SET-UP to exit The characters displayed on the 

'i^^^i\^^>::/iiiM.^ screen when entering SET-UP are 
^^^^^^^^^^^^^^^S again displayed on the screen. 
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Screen Brightness - The VT125 electronically controls screen bright- 
ness. The j (up arrow) key increases the screen brightness, the { (down 
arrow) key decreases the screen brightness. 

Use the following procedure to select the wanted screen brightness. 



JlPfefsiJ^^ 

again displayed on the screen. 

SET-UP A Features 

The following paragraphs describe SET-UP A features in detail. 

Characters Per Line - This feature selects a display of either 80 or 132 
characters per line. With 80 characters per line selected, the screen is 80 
characters wide and 24 lines long. With 132 characters per line selected, 
the screen is 132 characters wide and 14 lines long (132 characters by 
24 lines long if the advanced video option is installed). The displayed 
lines with 132 characters per line selected are the same width on the 
video screen as the 80 character per line selection, but the characters 
are narrow and closer together (Figure 2-4). 

NOTE: Changing the characters per line erases the current contents of 
the screen. 
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r 



These are characters displayed using 132 colums. 



MA-8391 



Figure 2-4 80- and 132-Column Displays 



Use the following procedure to select the number of characters per line. 



Procedure 



Indication /Comments 



Press SET-UP to 

enter SET-UP. 



SET-UP A is displayed on the 
screen. 



Press 80/ 132 
COLUMNS to select 
the number of columns 
per line. 

Press SET-UP to exit 
SET-UP, or press 

;S|T^ip :A/Sib; enter : 
SET-UP B. 



The bottom line of the display is a 
"ruler" that numbers each column 
position on a line. This ruler 
indicates the feature selection. 

The characters displayed on the 
screen before entering SET-UP are 
lost. When exiting SET-UP the 
screen is blank. 



Tabs - Tab stops are preselected points on a line of the VT125 display. 
The VT125 cursor can tab (advance) to the tab stops on the display line. 
The tab stops may be changed one at a time, or all cleared and then set. 

The 2 (SET/CLEAR TAB) key of the main keyboard sets and clears single 
tab stops. The 3 (CLEAR ALL TABS) key of the main keyboard clears all 
tab stop settings. 
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Use the following procedure to set and clear tab stops. 



Procedure 



Indication/Comments 



Press SET-UP to 
enter SET-UP. 



SET-UP A is displayed on the 
screen. 



Press CLEAR ALL 
TABS or SET/CLEAR 
TABS. 



Press SET-UP to exit 
SET-UP, or press 
SET-UP A/B to enter 
SET-UP B. 



All tabs are cleared. 

The tab is set or cleared at the 
cursor position. 

The cursor is moved using the 
^— (left arrow), — (right arrow), 
RETURN, TAB and space bar keys. 

The characters displayed on the 
screen when entering SET-UP are 
again displayed on the screen. 



SET-UP B Features 

Figure 2-5 is the SET-UP B summary. The bottom line of the display is a 
row of switches indicating the features selected. Use the following pro- 
cedure to change SET-UP feature switch selections. 



Procedure 



Indication/Comments 



PressJSE^-UP/to- 
enter SET-UP. 



B^T^UP A is dispfayeo; on the 



Press SET-UP A/B 

So enter SET-UP B. 



SET-UP B is displayed on the 



Position the cursor 
over the SET-UP 
feature switch to 
be changed. 

Use the TOGGLE 1/0 
key to select the 
feature. 



The cursor is positioned using the 
:*— (left arrow), — (right arrow), 
RETURN, TAB and spacebar keys. 



The screen displays the feature 
selection. 



Press SET-UP to exit 
SET-UP, or press 
SETUP A/B to enter 
SET-UP A. 



The characters displayed on the 
screen when entering SET-UP are 
again displayed on the screen. 
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■{? 



■ AUTO REPEAT 



= JUMP 
= SMOOTH 

= OFF 



{!: 



ON 






= DARKBACKGRND 
= LIGHT BACKGRND 



= UNDERLINE 
BLOCK 



MARGIN BELL 



{? 



= OFF 

= ON 



kevcl,ck{°:°- 1 

\NSI/VT52-/° 



rO = VT52 
= ANSI ' 



AUTO XON XOFF 



= OFF 
= ON 



U.S./U.K. 
'CHARACTER SET 



J = U.S. 
\1 = U.K. 



AUTO WRAP 



LINE FEED/ fO = OFF 
NEW LINE \1=ON 
= OFF 
: ON 



•INTERLACE 



= OFF 

1 =ON 



PARITY SENSE 



BITS PER CHAR 






ODD 
EVEN ' 



OFF 
ON 
BITS 
BITS 



60 Hz 
50 Hz 



-RESERVED = 

AUX PORT BITS J =7 BITS 
PER CHAR. \ 1 =8 BITS 



"} 



00 = 300 
AUX PORT I 01 = 1200 
SPEED ^10 = 2400 

1 1 = 9600 



Figure 2-5 SET-UP B Summary 



The following paragraphs describe the features in the order of the switch- 
es on the screen. The switches are referred to within this chapter by the 
group and the number of the switch within the group. (Example: switch 3-2 
is the third group of switches - second switch counting from left to right.) 
The answerback feature is listed at the end of the feature descriptions. 

SCROLL Switch 1-1:0 = Jump, 1 = Smooth 

Scrolling is the movement of text up or down on the screen. Scrolling is 
performed to make room for new lines at the bottom or top of the screen. 
It can be performed in two ways: jump or smooth scroll. 

With jump scroll selected, new lines are displayed on the screen as fast 
as the terminal receives them. At the higher baud rates, the lines dis- 
played are difficult to read because of their rapid movement. 

With smooth scroll selected, the speed at which new lines are displayed 
is limited. The movement of lines occurs at a smooth steady rate allowing 
the lines to be read as they are displayed on the screen. 



NOTE: Smooth scroll allows a maximum of six lines per second to be 
added at the top or bottom of the screen. The auto XON /XOFF feature 
must be supported by the computer to make sure that characters are not 
lost when smooth scroll is selected. 
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AUTO REPEAT Switch 1-2: = OFF, 1 = ON 

iiiiS iGSiuTG CaUSGS a KGy iC uG aliiGiTiaLiCaiiy rGpGalGu Si ific fSiG Ci 

about 30 characters per second when the key is held down for more than 
one-half second. The auto repeat feature affects all keyboard keys except 
the following. 

SET-UP 

ESC 

RETURN 

ENTER 

NO SCROLL 

CTRL and any key 

When the feature is turned off, only one character is transmitted each 
time the key is pressed. 

SCREEN BACKGROUND Switch 1-3: = Dark, 1 = Light 

This feature determines the background of the screen. With dark back- 
ground selected, the display has light characters on a dark background. 
With light background (reverse screen) selected, the display has dark 
characters on a light background (Figure 2-6). 



These are characters displayed on a dark background, 



r 



These are characters displayed on a light background. 



MA-8390 



Figure 2-6 Screen Background 
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CURSOR Switch 1-4: = Underline, 1 = Block 

This feature offers a choice of two cursor displays to indicate the "active 
position" or where the next character will be put on the screen. The cur- 
sor is displayed as either a blinking underline ( ) or a blinking block (■). 

If the advanced video option is not installed, this feature also affects the 
character attribute. Refer to Select Graphic Rendition on page 63. 

MARGIN BELL Switch 2-1:0 = OFF, 1 = ON 

While typing, this feature causes a bell tone to sound when the cursor is 
eight characters from the end of the current line. The margin bell can be 
turned on or off. The volume is not adjustable. 

KEYCLICK Switch 2-2: = OFF, 1 = ON 

This sound is generated every time a key is pressed. The keyclick can be 
turned on or off. However, research and experience has shown that an 
operator types fewer errors when there is an audible feedback from the 
keyboard. The keyclick volume is not adjustable. 

Aiiji/ v ■ Dz. owiiCn £.-o\ u= »i o^, i = mNoi 

The VT125 terminal follows two different programming standards - Ameri- 
can National Standards Institute (ANSI) and VT52 compatible. With ANSI 
selected, the VT125 generates and responds to control sequences ac- 
cording to ANSI standards X3.41-1974 and X3.64-1979. With VT52 com- 
patible selected, the VT125 terminal is compatible with previous DIGITAL 
software using the VT52 video terminal. But because the graphics proces- 
sor only uses ANSI, at power-up it sends the VT52 mode control function 
to the text terminal to force this SET-UP feature to ANSI regardless of the 
user permanent memory setting. After power-up, you must manually set 
this switch to use VT52 modes. 

AUTO XON/XOFF Switch 2-4: = OFF, 1 = ON 

The VT125 graphics processor requires the XON (DC1) and XOFF (DC3) 
control characters. Therefore, this feature cannot be turned off. Refer to 
the Communications chapter (Chapter 7) for more information about XON 
and XOFF. 

US/UK CHARACTER SET Switch 3-1: = #, 1 = £ 

The VT125 includes character sets for the United States and the United 
Kingdom. The difference between the two character sets is one character, 
the # (number) or £ (pound) symbol. 

AUTO WRAP Switch 3-2: = OFF, 1 - ON 

This feature selects where a received character is displayed when the 
cursor is at the right margin. When the auto wrap feature is off, the char- 
acter and all following characters are written into the last column of the 
current line. When this feature is on, the character is automatically dis- 
played on the next line. 
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LINEFEED/NEW LINE Switch 3-3: = OFF, 1 = ON 

Tl>:« f^«4..._« Jr.l..~.:.^. ik. ___J.__I _U — __ _j. — _/_\ x -xx j .,! r*^ 

iiiio icciiuic Cicici iiiii ico i.iic wOiiiivJi \Ji iai duici v**/ ii aiioi i ii lieu VViicM nt" 

TURN is pressed and what action is taken by the VT125 when it receives 
a linefeed control character (Table 2-3). 

When this feature is off (linefeed mode) pressing RETURN generates only 
the carriage return (CR) control character. When a linefeed (LF) control 
character is received, the cursor moves down to the next line and main- 
tains the current column position. 

When the linefeed /new line feature is on (new line mode), pressing RE- 
TURN generates the carriage return (CR) and linefeed (LF) control char- 
acters. When a linefeed control character is received, the character is re- 
sponded to as both a carriage return and linefeed. Therefore, a received 
linefeed causes the cursor to move to the left margin of the next line. 

NOTE: The meaning of linefeed varies according to your computer sys- 
tem's software. Be sure you need this feature before you turn it on. 



Table 2-3 Linefeed/New Line Feature Summary 



Selection 

Off 
Off 
On 
On 

Selection 

Off 
Off 

On 
On 



Key 

RETURN 

LINE FEED 

RETURN 

LINE FEED 

Character 
Received 

CR 

LF 

CR 

LF , ■ 



Character 
Sent 

Carriage return (CR) 

Linefeed (LF) 

Carriage return - linefeed (CR LF) 

Linefeed (LF) 

Function 

Carriage return (cursor moves to left margin) 

Linefeed (cursor moves to next line but stays in 
same column) 

Carriage return (cursor moves to left margin) 

Carriage return - linefeed (cursor moves to left 
margin on next line) 
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INTERLACE Switch 3-4: = OFF; 1 =0N 

This feature selects the number of scan lines used to create characters 
on the screen. With interlace on, the terminal uses 480 scan lines per 
screen. With interlace off, the terminal uses 240 scan lines per screen. 
This feature does not add any new information to the screen. However, 
when on, the interlace feature may improve the output of hardcopy or 
video devices connected to the video output connector. Usually oper- 
ators prefer to have this feature off. 

PARITY SENSE Switch 4-1:0 = ODD, 1 = EVEN 

This feature defines which of the two methods of parity checking, odd or 
even, is being used by the VT125. If the parity feature is on, the terminal's 
parity sense must be the same value as the parity the computer is send- 
ing. If the parity sense features do not match, most characters sent by the 
computer are rejected even though the character was received correctly 

Dy trie V I I £.0. II a ptuuy en ui uui/Ui S, me oi icv/Kciuuai u oi iai auici y ss / an 

pears on the screen instead of the received character. 

PARiTY Switch 4-2: = OFF, 1 = ON 

When on, this feature checks received data for correctness and adds a 
parity bit to transmitted data. If a received data error occurs, the VT125 
can detect it and show its presence by placing a checkerboard character 
(Sf) on the screen instead of the character with the error. The parity 
sense feature determines if the parity is even or odd. When parity is off, 
no parity bit Is received or transmitted. 

BITS PER CHARACTER Switch 4-3: = 7 Bits, 1 = 8 Bits 

This feature allows the terminal to transmit and receive either 7- or 8-bit 
characters. When set for 8-bit operation, bit 8 is set to a space (or 0) for 
characters transmitted and is ignored for all characters received. 

POWER Switch 4-4: = 60 Hz, 1 = 50 Hz 

During the initial installation of the VT125, this feature must be set to the 
power line frequency. In the United States this setting is 60 Hz. When us- 
ing 50 Hz line frequency, set this feature to 50 Hz. 

AUX PORT Switch 5-2: = 7 Bits, 1 = 8 Bits 

BITS PER CHARACTER 

This switch sets the auxiliary port to match the character length of your 
printer or other serial device. When set to 8 bits, the eighth bit is a space. 
This is the same as 7S or 8N on other terminals. 

AUX PORT SPEED Switches 5-3 and 5-4 

These switches set the auxiliary port to one of four baud rates. 



xxoo 


300 baud 


XX01 


1200 baud 


XX10 


2400 baud 


XX11 


9600 baud 



Set the switches to match the speed of your auxiliary device. 
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TRANSMIT SPEED 

Transmit speed must be set to match the computer receive speed. The 
VT125 can transmit at any one of the following speeds: 50, 75, 110, 
134.5, 150, 200, 300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 9600, 
and 19200 baud. 

Transmit speed is independent of receive speed. The terminal may trans- 
mit data at one speed and receive data at a different speed. 

Use the following procedure to change the transmit speed. 



Procedure 



Indication /Comments 



Press SET-UP to 
enter SET-UP. 



SET-UP A is displayed on the 
screen. 



Press SETUP A /B 
to enter SET-UP B. 



SET-UP B is displayed on the 
screen. 



Press TRANSMIT 
SPEED to select 
the transmit speed. 

Press SET-UP to exit 
SET-UP, or press 
SETUP A/B to enter 
SET-UP A. 



The terminal displays the current 
feature selection. 



The characters displayed on the 
screen when entering SET-UP are 
again displayed on the screen. 



RECEIVE SPEED 

Receive speed must be set to match the computer transmit speed. The 
VT125 can receive at any one of the following speeds: 50, 75, 1 10, 134.5, 
150, 200, 300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 9600, and 
19200 baud. 



Receive speed is independent of transmit speed. The terminal may re- 
censmit speed. The VT125 can receive at any one of the following 
speeds: 50, 75, 110, 134.5, 150, 200, 300, 600, 1200, 1800, 2000, 2400, 
3600, 4800, 9600, and 19200 baud. 

Receive speed is independent of transmit speed. The terminal may re- 
ceive data at one speed and transmit data at a different speed. 
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Use the following steps to change the receive speed. 



Procedure 



Indication /Comments 



Press SET-UP to 
enter SET-UP. 



SET-UP A is displayed on the 
screen. 



Press SETUP A/B to 

enter SET-UP B. 



SET-UP B is displayed on the 
screen. 



Press RECEIVE 
SPEED to select 
the receive speed. 

Press SET-UP to exit 
SET-UP, or press 

CCTI ID A /O ♦/-» ontor 

SFT-tlP A. 



The terminal displays the current 
feature selection. 



The characters displayed on the 
screen when entering SET-UP are 

anain riionlavori nn tho srrPAn 



Answerback Message 

This feature provides the VT125 with the capability of transmitting an 
identifying message to the computer. The answerback message is trans- 
mitted to the computer under the following conditions. 

1. The answerback message is transmitted under a direct request for 
identification by the computer. The complete answerback sequence 
happens automatically without affecting the screen or requiring oper- 
ator action. 



2. The operator manually transmits the answerback message. While 
pressing CTRL, press BREAK, then release both keys to manually 
transmit the answerback message. 
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Enter an answerback message using the following steps (refer to Figure 



Procedure 



Indication / Comments 



1. Press SET-UP to 

enter SET-UP. 



SET-UP A is displayed on the 
screen. 



2. Press SETUP A/B 

to enter SET-UP B. 

3. Hold down SHIFT, 
press A, and release 
both keys. 

4. Type the message 
delimiter character. 



5. Type the answerback 
; . ; ; message ' . :;;; 



7. 



If less than 20 
characters are in 
the message, type 
the delimiter 
character. 



Press SET-UP to exit 
SET-UP, or press 
SETUP A/B to enter 
SET-UP A. 



SET-UP B is displayed on the 
screen. 

The terminal displays A = (refer to 
Figure 2-7. 



This is any character not used in the 
answerback message. The message 
delimiter character is not transmitted 
as part of the answerback message. 

The answerback message may be up 
to 20 characters. If control charac- 
ters are used they are displayed as 
the ( + ) character. 

If you make a mistake while typing 
the message, type the delimiter 
character (used in step 4) and 

answerback message. 

If 20 characters are typed, the 
message is automatically entered 
into operating memory. If less than 
20 characters are typed the de- 
limiter character is used to enter the 
message into operating memory. 

The characters displayed on the 
screen when entering SET-UP are 
again displayed on the screen. 
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SET-UP B 



TO EXIT PRESS "SET-UP" 



DELIMITER CHARACTER 



ANSWERBACK MESSAGE 
I 



S= I UP TO 20 CHARACTERS 

1 W 2ffl 3H *1 SI 



T SPEED 9600 R SPEED 9600 



Figure 2-7 Answerback Message 



TRANSMITTED 
CHARACTERS 



B 



GENERAL 

This chapter describes the character codes generated by the VT125 ter- 
minal. The keys are divided into three groups: standard, function, and 
auxiliary keypad keys. 



diAiHUAnu rvcra 
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ican Standard Code for Information Interchange (ASCII) character codes. 
Lowercase ASCII character codes are generated when SHIFT or CAPS 
LOCK are not pressed. Uppercase ASCII character codes are generated 
when either SHIFT or CAPS LOCK are pressed. CAPS LOCK does not af- 
fect the nonalphabetic keys. 



OCTAL CODES GENERATED BY KEYBOARD 











[SHIFTED CODES SHOWN ABOVE K 


fcY 


uah 


LLC 


ibNL 


JS 
























UNSHIFTED CODES SHOWN BELOW KEYCAP LEGENDS) 
















041 


100 


043 


044 


045 


136 


046 


052 


050 


051 


137 


153 


176 










1 ! 


2& 


3# 


4$ 


5% 


6 A 


7& 


8 " 


9( 


0) 





= + 


\ - 










061 


062 


063 


064 


065 


066 


067 


070 


071 


060 


055 


075 


140 










121 


127 


105 


122 


124 


131 


125 


111 


117 


120 


173 


175 












Q 


W 


E 


R 


T 


Y 


U 


I 





P 


I! 


II 












161 


167 


145 


162 


164 


171 


165 


151 


157 


160 


133 


135 










CAPS 


101 


123 


104 


106 


107 


110 


112 


113 


114 


072 


042 






174 






A 


S 


D 


F 


G 


H 


J 


K 


L 








\| 






LOCK 


141 


163 


144 


146 


147 


150 


152 


153 


154 


073 


047 




134 


















132 


130 


103 


126 


102 


116 


115 


074 


076 


077 










SHIFT 


Z 


X 


C 


V 


B 


N 


M 


, < 


> 


/? 


SHIFT 










172 


170 


143 


166 


142 


156 


155 


054 


056 


057 










040 








SPACE 
















040 
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Figure 3- 1 Standard Key Codes 
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Figure 3-2 Function Keys 

FUNCTION KEYS 

The function keys are shown in Figure 3-2. These keys generate charac- 
ter codes whose function is defined by the computer software or commu- 
nication system. The following paragraphs describe the function keys. 

BREAK 

This key generates a Break signal. The Break signal function is defined by 
the computer system. Refer to the Communications chapter (Chapter 7) 
for more information about the Break signal. 

Hold down SHIFT, and press BREAK to generate a long break disconnect. 
This usually disconnects the terminal from the communication line. Refer 
to Chapter 7 for more information about long break disconnect. 

Hold down CTRL, and press BREAK to generate the answerback mes- 
sage. Refer to the SET-UP chapter (Chapter 2) for more information about 
the answerback SET-UP B feature. 

Cursor Control Keys 

The cursor key character codes generated by the terminal depend on the 
ANSI/VT125 feature selection. When the ANSI/VT125 feature is set for 
ANSI compatibility, the cursor keys generate sequences that depend on 
the cursor key mode selection. Cursor key mode is only selected by the 
computer. Refer to the Received Character Processing chapter (Chapter 
4) for more information about cursor key character selection. Table 3-1 
lists the ANSI and VT52 compatible cursor key character codes. 
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Table 3-1 Cursor Control Key Codes 

Cursor Key Cursor Key 

Cursor Key Mode Reset Mode Set VT52 Mode 

;T ESC [ A ESC O A ESC A 

033 133 101 033 117 101 033 101 

I ESC [ B ESC O B ESC B 

033 133 102 033 117 102 033 102 

- ESC [ C ESC O C ESC C 

033 133 103 033 117 103 033 103 

ESC [ D ESC O D ESC D 

033 133 104 033 117 104 033 104 



Control Character Keys 

Figure 3-3 shows the keys that generate control characters. Control char- 
acters can be generated in two ways. 

1. Hold down CTRL, and press any of the unshaded keys in Figure 3-3. 

2. Press any of the shaded keys in Figure 3-3 without using CTRL. The 
shaded keys are dedicated keys that generate control characters 
without using CTRL. 

NOTE: The RETURN key character code can be changed by the 
linefeed/new line feature. When off, this feature causes RETURN to 
generate a single control character (CR). When on, this feature 
causes RETURN to generate two characters (CR, LF). Also, depend- 
ing on the auxiliary keypad mode selected, RETURN and ENTER 
may generate the same control codes. 

Table 3-2 lists the control characters that are generated differently from 
previous DIGITAL terminals. No details are provided about the function of 
the control character codes because different computer systems may use 
each control character differently. 
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1 

1 






MNEMONICS SHOWN ABOVE KEYCAP LEGENDS 
OCTAL CODES SHOWN BELOW KEYCAP LEGENDS 














i I 
I I 


■ 


























RS 
\ - 
036 


■ 


BREAK 


B 


XON 

Q 
021 


ETB 
W 
027 


ENQ 

E 
005 


DC2 

R 
022 


DC4 

T 
024 


EM 

Y 

031 


NAK 

U 
025 


HT 

I 

011 


SI 



017 


DLE 

P 
020 


ESC 

II 

033 


GS 

II 
035 




II 


1 



CTRL 




SOH 

A 
001 


XOFF 

S 
023 


EOT 

D 
004 


ACK 

F 
006 


BEL 

G 
007 


BS 

H 

010 


LF 

J 

012 


VT 

K 

013 


FF 

L 

014 












SUB 

Z 
032 


CAN 

X 
030 


ETX 

C 
003 


SYN 

V 
026 


STX 

B 
002 


SO 

N 

016 


CR 

M 

015 


, < 


> 


US 
/? 
037 





I 



FS 

\| 
034 



NUL 
000 



Figure 3-3 Function Key Control Codes 



Table 3-2 Comparison of Control Character Generation 



Code 



VT125 
Keys 



NUL CTRL - Space bar 

RS CTRL-- 

US CTRL-? 



Previous Terminal Keys 

CTRL-® 
CTRL-^ 
CTRL-_ 
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AUXILIARY KEYPAD KEYS 

The characters generated by the auxiliary keypad keys change depend- 
ing on the selection of two features: ANSI/VT52 and alternate keypad 
features. The alternate keypad feature is usually selected only by the 
computer. Refer to the Received Character Processing chapter (Chapter 
4) for more information about keypad character selection. 

When alternate keypad mode is not selected (numeric keypad mode is 
selected), the auxiliary keypad generates the numeric, comma, period, 
and minus sign character codes used by the main keyboard. 

NOTE: SHIFT and CAPS LOCK do not affect the codes generated by the 
auxiliary keypad. 

When alternate keypad mode is selected, the auxiliary keypad generates 
control functions. Table 3-3 lists the character codes generated b v the 
auxiliary keypad. 



Table 3-3 Auxiliary Keypad Codes 



Key 




8 



Numeric 

Keypad 

Mode 


ANSI Mode 

Alternate 

Keypad 

Mode 





060 


ESC 
033 117 


P 
160 


Sliiilil 

061 


ESC O 
033 117 


q 

161 


IBIHiS 

062 


ESC O 
033 117 


Hiill 

162 


063 


ESC O 
033 117 


s 
163 


BilllliJ 

064 


ESC 
033 117 


SIS* 

164 


llilllii 

065 


ESC 
033 117 


u 
165 


6 
066 


ESC 
033 117 


V 

166 


067 


ESC 
033 117 


w 
167 


8 
070 


ESC O 
033 117 


170 


9 
071 


ESC 
033 117 


y 

171 



VT52 Mode 
Numeric Alternate 

Keypad Keypad 

Mode Mode 




060 

lllll 
060 

2 
062 

3 
063 

4 
064 

5 
065 

6 
066 

7 
067 

8 
070 

9 
071 



ESC 
033 


? 
077 


P 
160 


ESC 
033 


? 
077 


q 

161 


ESC 
033 


? 
077 


iilill 

162 


ESC 
033 


? 
077 


s 
163 


ESC 


? 


lltlt 


033 


077 


164 


ESC 
033 


? 
077 


165 


ESC 
033 


? 
077 


v 
166 


ESC 
033 


? 
077 


w 
167 


ESC 
033 


? 
077 


x 
170 


ESC 
033 


? 
077 


y 

171 
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Key 



Numeric 

Keypad 

Mode 



ANSI Mode 

Alternate 

Keypad 

Mode 



Numeric 

Keypad 

Mode 



VT52 Mode 

Alternate 

Keypad 

Mode 



- (minus) 
055 



ESC O m 

033 117 155 



-(minus)* 
055 



ESC ? m * 

033 077 155 



, (comma) 
054 



ESC O 
033 117 



! 
154 



, (comma)* 
054 



ESC ? I 1 

033 077 1 54 



. (period) 
056 



ESC O n 

033 117 156 



. (period) 
056 



ESC ? n 

033 077 156 



ENTERt 



CR or CR LF 
015 015 012 



ESC O M 
033 117 115 



CR or CR LF 
015 015 012 



ESC ? M 

033 077 115 



PF1 



ESC O P 
033 117 120 



ESC O P 

033 117 1 20 



ESC P 
033 120 



ESC ? P 

033 077 120 



PF2 



ESC Q 

033 117 121 



■:!ESG--^<3^:: ; -;-Q- 
033 117 121 



ESC Q 
033 121 



ESC ? Q 

033 077 121 



PF3 



:esc : R 

;633 : ^ : 1.17;.:1:22.: : 



ESC 
033 



,:0-.:,-/. ; -''R : :.; 
117 1 22 



ESC R 
033 122 



.esc. \ ; '. : ?'v'-.v;:-;r^ : - 

033 077 122 



PF4 



033 ^17 123 



ESC O 
033 117 



S 
123 



ESC S* 
033 123 



ESC ? S* 

033 077 123 



These sequences were not available in the W 

liinllllsMli^^ 



t When numeric keypad I mode is seie^ed (alternate keypad mode off), the ENTER character code can be 
changed by the i in efee 

control character (CR, octalOl 5). When on, this feature causes ENTER to generate two characters (CR, 
octal 01 5 and LF, octal 01 2). 




Received 

Character Processing 




RECEIVED CHARACTER 
PROCESSING 



GENERAL 

This chapter describes the terminal's response to received data. Most of 
the data are dispiayable characters that appear on the screen with no 
other effect. But a type of data, called control functions, has important ef- 
fects on the operation of the terminal. 

rv control i unction is one or more cnaracter codes that provide control of 
the transmission, processing, and display of characters. Control functions 
command the VT125 to change its operations, for example, by controlling 
and commanding graphics protocols, changing its response to other con- 
trol functions, erasing parts of the screen, ringing the bell, or selecting 
character sets. The VT125 can also transmit control functions to the com- 
puter, either with special keys or at the request of the computer. 

This chapter explains the implementation of control functions using con- 
trol characters, escape sequences, control sequences, and device con- 
trol strings. This implementation is explained according to standards cre- 
ated by the American National Standards Institute (ANSI) and the 
International Organization for Standardization (ISO). The words used are 
defined, and all control functions that the VT125 understands are listed 
and explained. For VT125 features that do not have an ANSI standard 
control function, DIGITAL private control functions have been defined with- 
in the extensions permitted by the ANSI standards. A detailed explanation 
of the format of ANSI control functions is in Appendix E. 

Each control function has a unique name, and each name has a unique 
abbreviation. The name and abbreviation are standardized. The abbrevia- 
tion is derived from the name to help the programmer remember its mean- 
ing, and so it is also called a mnemonic. This book lists the mnemonic with 
the control function name. 

ERRORS 

A control function that is not understood by the VT125 is ignored. Unsup- 
ported control functions (any sequences that meet ANSI specifications 
but are not listed in this document) are generally ignored but may produce 
unexpected responses. 
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If a control character appears in the middle of a sequence (including the 
rules. 



vjcviOc OiJiiiiUi oiiniyo \Ji iii\s yi a(-ii iiCo piUOcooui/, iiio V i i £.0 Ubca uicoc 



1. XON and XOFF always function as defined in the Communications 
chapter (Chapter 7). 

2. ESC, CAN, and SUB always stop a control function in process with- 
out considering which device was receiving the control function. NUL 
and DEL are fill characters when received by the terminal. 

3. Any other control characters are understood as part of the sequence 
that they are in. If the communication data paths in the VT125 are set 
to pass the control sequence to another device (such as the VT100 
or the auxiliary port) any control characters in the control sequence 
also pass to the other device. Both the text terminal and the graphics 
processor understand a control character inside a control sequence 
as if the control character arrived before the control sequence. (The 
graphics processor ignores these other control characters.) 

4. Any control characters or control sequences received inside a de- 
vice control string introducer /string terminator (DCS /ST) pair is 
passed to the process or device that was selected by the last DCS. 
But, no DCS or ST that is understood as a data path control switch is 
passed to another device or process. The graphics processor ig- 
nores a DCS inside a DCS /ST pair. 

ASCII TABLE AND RECEIVED CHARACTERS 

The VT125 terminal processes characters according to the codes shown 
in the ASCII table (Table 4-1). This table is a part of the ANSI standards. It 
is the American Standard Code for Information Interchange (ASCII) and is 
also ISO Standard 646 and Consultive Committee for International Tele- 
phone and Telegraph (CCITT) Alphabet 5. Table 4-1 shows each charac- 
ter with its binary, octal, decimal, and hexadecimal vaiues. The table is 8 
columns wide and 16 rows long. This arrangement allows binary relation- 
ships between characters. For example, lower- and uppercase letters 
differ only by the value of bit 6. 

The VT125 processes a received character based on the type of charac- 
ter as defined by ANSI. Control characters (refer to the following para- 
graphs) are all in the first two columns of the table (except Delete). All 
other characters are displayable characters with the exception of Space 
(SP). SP can be considered either an information separator or a dis- 
playable character. 



Table 4-1 ASCII Table 
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DISPLAYABLE CHARACTERS 

These characters are displayed on the screen when received. The char- 
acter displayed on the screen depends on the character set selection. 
The character set is selected using control functions. Refer to Character 
Sets and Selection on page 57 for more information about character sets. 

Control Characters Received 

A control character is a single character which, when received by the ter- 
minal, starts, modifies, or stops a control function. The value of a control 
character is in the octal range of through 37 and 177. 

The control characters that the VT125 understands are shown in Table 4- 
2 and described in the following paragraphs. All other control codes are 
ignored by the VT125. 



Table 4-2 Control Characters Recognized by VT1 25 



Control 

Character 

Mnemonic 

NUL 



ENQ 
BEL 
BS 



Octal 

Code Name 



HT 



LF 



SO 



000 



016 



Null 



005 Enquire 

007 Bell 

010 Backspace 



01 1 Horizontal 

tab 



012 Linefeed 



VT 


013 


Vertical 
tab 


FF 


014 


Form feed 


CR 


015 


Carriage 
return 



Shift out 



Action Taken 

Ignored on input (not stored in 
input buffer; refer to full-duplex 
protocol) 

Transmits answerback message 

Sounds the bell 

Moves the cursor to the left one 
character position. If it is at the left 
margin, it stays there 

Moves the cursor to the next tab 
stop, or to the right margin if there 
are no more tab stops in the line 



Causes a linefeed or a new line 
operation (refer to Linefeed/New 
Line mode) 

Understood as LF 



Understood as LF 

Moves the cursor to the left 
margin on the current line 

Select G1 character set as des- 
ignated by a Select Character Set 
sequence 
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Table 4-2 


Control Characters Recognized by VT1 25 (Cont) 


Control 




Character 


Octal 


Mnemonic 


Code Name Action Taken 


SI 


01 7 Shift in Select GO character set as des- 




ignated by a Select Character Set 




sequence. 


DC1 


021 Device Understood as XON; lets terminal 




control 1 continue transmission after XOFF 


DC3 


023 Device Understood as XOFF; tells ter- 




control3 minal to stop transmitting all char- 



CAN 



030 



Cancel 



SUB 
ESC 

DEL 



032 Substitute 

033 Escape 



177 



Delete 



acters except XOFF and XON 

If received during an escape or 
control sequence, cancels the 
sequence and displays the substi- 
tution character .§. Any characters 
from the sequence that follow the 
cancel character are displayed 
after the substitution character 

Understood as CAN 

Understood as introducer of an 
escape sequence 

Ignored on input (not stored in 
input buffer) 



SEQUENCES 

The VT125 is an upward and downward software-compatible terminal; that 
is, previous DIGITAL video terminals have DIGITAL private standards for 
escape sequences. The VT125 is compatible with both the previous 
DIGITAL standard and the ANSI standards. Customers may use existing 
DIGITAL software designed around the VT52 or new VT125 software. The 
VT125 has a "VT52 compatible" mode in which it responds to escape se- 
quences like a VT52. 

Throughout this section of the manual references will be made to "VT52 
mode" or "ANSI mode". These two terms are used to indicate the 
VT125's software compatibility. All new software should be designed 
around the VT125 ANSI mode. (All graphics software must use ANSI 
mode.) Future DIGITAL video terminals will not be committed to VT52 
compatibility. 



All of the following escape and control sequences are transmitted from 
the computer to the VT125 unless otherwise noted. All of the escape se- 
quences are a subset of those specified in ANSI X3.64-1979 and ANSI 
X3.41-1974. 
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This chapter groups the sequences by function. Table 4-3 lists the order 
of the groups and each group's starting paye number. 

Figure 4-10 (at the end of the chapter) is a one-page summary of the ANSI 
mode display control functions. These control functions directly or in- 
directly affect the way the screen looks. 

A summary of all control functions is in Appendix C. 

Table 4-3 Escape and Control Sequence Arrangement 

Sequence Page 

VT125 SET-UP Feature and Mode Selection 47 

VT1 25 Character Sets and Selection 57 

VT1 25 Scrolling 65 

VT1 25 Cursor Positioning 66 

VT125Tabs 69 

VT1 25 Line Attributes 70 

VT125 Erasing 71 

VT125 Communication and Graphics Protocol Controls 73 

VT125 Reports 77 

VT1 25 Reset 80 

VT1 25 Tests and Adjustments 81 

VT125 Indicators 84 

VT52 Modes 86 

VT52 Character Sets and Selection 88 

VT52 Cursor Positioning 90 

VT52 Erasing 91 

VT52 Reports 92 
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ANSI SEQUENCES 

SET-UP FEATURE AND MODE SELECTION 

SET-UP features are terminal characteristics that can be controlled from 
the keyboard and stored in the user permanent SET-UP feature memory. 
Some SET-UP features can also be changed from the computer, but the 
computer cannot store them in the user permanent memory. Some SET- 
UP features are terminal modes. Table 4-4 lists the VT125 SET-UP fea- 
tures and modes. 

Table 4-4 SET-UP Features and Terminal Modes 





Changeable 


Changeable in 


SET-UP Feature or 


from 


SET-UP and 


Terminal Mode 


Computer* 


Stored in NVR 


ANSI/VT52 mode 


Yes (DECANM) 


Yes 


Auto repeat mode 


Yes (DECARM) 


Yes 


Autowrap mode 


Yes (DECAWM) 


Yes 


AUTO XON XOFF 


ii^&iflS&Kti 


Yes 


Bits per character 


9Ufftii99lt0$ 


Yes 


Column mode (char/line) 


Yes (DECCOLM) 


Yes 


Cursor 


No 


Yes 


Cursor keys mode 


Yes (DECCKM) 


No 


Keyclick 


No 


Yes 


Keypad application mode 


Yes (DECKPAM) 


No 


Keypad numeric mode 


Yes(DECKPNM) 


No 


Linefeed/new line mode 


Yes (LNM) 


Yes 


Margin bell 


mrhmnmmbii 


Yes 


Origin mode 


Yes (DECOM) 


Yes 


Parity 


MBMK1BBBMI 


Yes 


Parity sense 


WS^^^^^^K 


Yes 


Power 


fM^KItUSlitiM 


Yes 


Auxiliary port bits per char 


W^U§MffiSiMitlt 


Yes 


Auxiliary port speed 


t^SSitiSSSA 


Yes 


Receive speed 


iSBtilllllllilfft 


Yes 


Screen mode 


Yes (DECSCNM) 


Yes 


Scroll mode 


Yes(DECSCLM) 


Yes 


Tabs 


Yes (HTS/TBC) 


Yes 


Transmit speed 


No 


Yes 


US/UK char set 


Yes (SCS) 


Yes 



* The control or escape sequence mnemonic that applies is indicated in 
parentheses 
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A mode is a state of the terminal that affects the operation of the terminal 

r\r knui +Ka tarmlnol nnHoreion/Je r\r trnnnmi4n rlntn fcJlyv^J^^ « -^ a/vU>1>J U. , 
v . ..w.. ...w ...-. ««• unviuiutuiiuu vi iiumuiiiiiu ciuiu. iViuugg 01 *S ocicv^icu jjy 

either the computer or the operator. The terminal stays in a mode until the 
computer or operator changes the mode setting. 

Modes may be changed with the set mode (SM) and reset mode (RM) 
commands, except for keypad numeric and application modes. (These 
modes are changed using dedicated sequences.) Multiple parameters 
may be included in a single command. 



NOTE: Ps represents a variable parameter selected from a list of param- 
eters. A series of asterisks (* * *) represent the parameter in the octal se- 
quence. Each parameter listed represents a mode. When you set several 
modes with a single SM or RM sequence, a semicolon (octal 073) sepa- 
rates parameters. The semicolon is not used when selecting only one 
mode. 

Set Mode (SM) 

ESC [ Ps ; ... ; Ps h default value: none 

033 133 *** 073 073 *** 150 

The above command causes one or more modes to be set within the 
VT125 as specified by each parameter in the parameter string. Each 
mode to be set is specified by a separate parameter. A mode is consid- 
ered set until it is reset by a reset mode (RM) control sequence or is in 
SET-UP. 



Reset Mode (RM) 

ESC [ Ps ; ... ; Ps I default value: none 

033 133 *** 073 073 *** 154 

The above command resets one or more VT125 modes as specified by 
each parameter in the parameter string. Each mode to be reset is speci- 
fied by a separate parameter. 



The following is a list of VT125 modes that may be changed with set mode 
and reset mode. 

ANSI Specified Modes 

Parameter Mode Function Mode Mnemonic 

Error (ignored) 

20 Auto linefeed /new line mode LNM 
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DIGITAL Private Modes 

NOTES 

1. The first character in the DIGITAL private parameter string is ? (77(8)). 
The parameters are understood according to Table 4-5. Any other pa- 
rameter values are ignored. 

2. Keypad Application Mode (DECKPAM) and Keypad Numeric Mode 
(DECKNM) are changed using two special two-character sequences; 
not the usual set and reset mode sequences. 

The modes in Table 4-6, (specified in the ANSI X3.64-1979 standard) may 
be considered to be permanently set, permanently reset, or not applying, 
as indicated. Refer to that standard for more information about these 
modes. 

The following modes are listed alphabetically by name (refer to Table 4-4). 



Table 4-5 DEC Private Modes 

Mode Mode 

Parameter Function Mnemonic 

Error (ignored) 

i ouisui i\ey ur£:vsvjr\ivi 

2 ANSI/VT52 DECANM 

3 Column DECCOLM 

4 Scrolling DECSCLM 

5 Screen DECSCNM 

6 Origin DECOM 

7 Auto wrap DECAWM 

8 Auto repeat DECARM 
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i able 4-b permanently Selected ivioaes 

Name State Mnemonic and Description 



Control 
representation 



Editing 
boundary 



Reset 



Reset 



Erasure 


Set 


Format 
effector action 


Reset 


Format 
effector transfer 


:^iff£ 


Guarded 
area transfer 


IP'^Ji; 


Horizontal 
editing ;;: : 


111111111 


replacement 


Reset 


Keyboard 
action 


Reset 


Multiple 
area transfer 


llllSllll 


unit 


Reset 


Selected 
area transfer 


llllilll 


Status 

reporting 

transfer 


Reset 


Tabulation 
stop 


Reset 


Transfer 
termination 


llllilll 


Vertical 
editing 


lllllll 



CRM - Control functions are performed without- 
displaying a character to represent the control 
function received. 

EBM- Characters moved outside the margins are 
lost and erasing and cursor positioning functions 
are not performed outside the margins. 

ERM - All characters displayed can be erased. 

FEAM - Control functions that affect the screen 
display are performed immediately. 

FETM 



GATM 



HEM 



IRM- Received characters replace the characters 

KAM - Typed characters are processed except 
when the keyboard is locked. 

matm 



PUM- Horizontal and vertical parameters i:p 
control functions are specified in units of 

:;SMM^AS^.,-'v:^:^. : :': 



SRTM - Status reports are transmitted by the 
VT1 25 using the Device Status Report (DSR) 
sequence. 

TSM - The tab stop selection applies to the 
corresponding column of all lines on the screen. 

TTM 



VEM 
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ANSI/VT52 Mode (DEC Private) (DECANM) 

This mode changes the cursor key and auxiliary keypad codes. (Refer to 
Cursor Keys Mode and Keypad Application and Keypad Numeric Modes.) 
This mode must be set to ANSI or the graphics processor cannot work. 

Set: (From VT52 Mode) ESC < 

033 074 

The set state causes only ANSI escape and control sequences to be un- 
derstood and executed. 



Reset: ESC [ ? 2 I 

033 133 077 062 154 

The reset state causes only VT52 compatible escape sequences to be 
understood and executed. 

Auto Repeat Mode (DEC Private) (DECARM) 

Set: ESC [ ? 8 h 

033 133 077 070 150 

The set state causes keyboard keys to auto repeat except SET-UP, EN- 
TER, ESC, RETURN, NO SCROLL, and CTRL with any key. 



Reset: ESC [ ? 8 I 

033 133 077 070 154 

The reset state causes no keyboard keys to auto-repeat. 



Autowrap Mode (DEC Private) (DECAWM) 

Set: ESC [ ? 7 h 

033 133 077 067 150 

The set state turns autowrap on. If a displayable character is received 
when the cursor is at the right margin, the set state causes the cursor to 
advance to the start of the next line. A scroll up is done if needed and if 
the cursor has not been positioned outside of the scrolling region. 



Reset: ESC [ ? 7 I 

033 133 077 067 154 

The reset state turns autowrap off. If a character is received while the 
cursor is at the right margin the reset state causes it to replace any char- 
acters previously there. 
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Column Mode (DEC Private) (DECCOLM) 

Set: ESC [ ? 3 h 

033 133 077 063 150 

The set state causes a maximum of 132 columns on the screen (Figure 
4-1). 



Reset: ESC [ ? 3 I 

033 133 077 063 154 

The reset state causes a maximum of 80 columns on the screen (Figure 
4-1). 



r 



These are characters displayed using 80 col linns. 



r 



These are characters displaced using 132 coluns. 



MA-8391 



Figure 4-1 Column Mode 
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Cursor Keys Mode (DEC Private) (DECCKM) 

This mode is only effective when the terminal is in ANSI mode. Table 4-7 
shows the sequences generated by each key. 

Set: ESC [ ? 1 h 

033 133 077 061 150 

The four cursor keys send application control functions. 



Reset: ESC [ ? 1 I 

033 133 077 061 154 

The four cursor keys send ANSI cursor control commands. 



Linefeed/New Line Mode (LNM) 

This mode does not affect index or Next Line (Table 4-8). 

Set: ESC [ 2 h 

033 133 062 060 150 



Table 4-7 Cursor Control Key Codes 



Cursor Key 
(Arrow) 

Up 

Down 
Right 
Left 



Mode Reset 

ESC [A 
ESC[B 
ESC[C 
ESC[D 



Mode Set 

ESCOA 
ESC OB 
ESCOC 
ESCOD 



Table 4-8 Linefeed/Newline Mode 



Linefeed/ 



New Line Mode 


Key Pressed 


Code Sent 


Reset 


RETURN 


WSKSi^^KlM 


Reset 


LINE FEED 


iliiiliiiiiifBI 


Set 


RETURN 


CR LF 


Set 


LINE FEED 


IliSilfiSIISIIIf 


Linefeed/ 






New Line Mode 


Code Received 


Action Taken 


Reset 


CR 


Return 


Reset 


W&lm^SmM&A. 


Linefeed 


Set 


CR 


Return 


Set 


LF 


Return- Linefeed 
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The set state causes received linefeed (LF) to move the active position to 
the first position of the foiiowing iine (new iine) 
to send the two codes (CR, LF). 



m. nrTiinki ir^n\ 

t (jdubcb riiu ■ wnri \wi «/ 



Reset: ESC [201 

033 133 062 060 154 

The reset state causes linefeed to move the active position down only 
(linefeed), and causes RETURN to send the single code CR. 



Keypad Application Mode (DEC Private) (DECKPAM) 

ESC = 

033 075 

The auxiliary keypad keys and cursor control keys transmit escape se- 
quences. Table 4-9 lists the sequences. 



Table 4-9 ANSI Mode Auxiliary Keypad Codes 





Keypad 


Keypad 


Key 


Numeric Mode 


Application Mode 








ESC O p 


1 


1 


ESCOq 


2 


2 


ESC Or 


3 


3 


ESCOs 


4 


4 


ESC O t 


5. 


5 


ESCOu 


6 


6 


ESCOv 


7 


7 


ESCOw 


8 


8 


ESC Ox 


9 


9 


ESCOy 


-(minus) 


-(minus) 


ESCOm 


, (comma) 


.(comma) 


ESCOI 


. (period) 


. (period) 


ESC On 


ENTER 


Same as RETURN key 


ESCOM 


PF1 


ESC OP 


ESC O P 


PF2 


ESCOQ 


ESC O Q 


PF3 


ccr r\ d 


ESC OR 


PF4 


ESC OS 


ESC O S 
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Keypad Numeric Mode (DEC Private) (DECKPNM) 

ESC > 

033 076 

The auxiliary keypad keys send ASCII codes corresponding to the char- 
acters on the keys (except for the PF keys and ENTER). The cursor con- 
trol keys send cursor controls. Table 4-9 lists the sequences. 



NOTE: In ANSI mode, if the codes are echoed back to the VT125, or if 
the terminal is local, the last character of the sequence is displayed on 
the screen. For example, PF1 is displayed as a "P". Refer to SS2 and 
SS3 in Character Sets and Selection on page 63. 



Origin Mode (DEC Private) (DECOM) 

Lines and columns are numhprpri rnncorn+iuoK/ tA/i+h +k« ^-j^.:^ u~: i:__ 

1, column 1. The cursor is moved to the new home nncitinn w h P n +hio 
mode is set or reset. 

Set: ESC [ ? 6 h 

033 133 077 066 150 

The set state causes the origin to be at the upper-left character position 
within the margins of the scrolling region (refer to Scrolling). This is the 
home position when origin mode is set. Line numbers are relative to the 
current margin settings. For example, if the top margin is line 5, the top 
line is addressed as line 1 for cursor positioning. (Home position is there- 
fore line 5, column 1, absolute.) The cursor is not allowed to be positioned 
outside the margins. 



Reset: ESC [ ? 6 I 

033 133 077 066 154 

The reset state causes the origin to be at the upper-left character position 
on the screen. This is the home position when origin mode is reset. Line 
numbers are absolute and are not affected by the current margin settings. 
The cursor may be positioned outside the margins with a Cursor Position 
or Horizontal and Vertical Position control sequence. 

Screen Mode (DEC Private) (DECSCNM) 

Set: ESC [ ? 5 h 

033 133 077 065 150 

The set state causes the screen to be white with black (reverse) charac- 
ters (Figure 4-2). 
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DECSCNM-SCREEN 



REVERSE ESC [?5h 
(BLACK-ON-WHITE) 



El 



, - NORMAL ESC [?51 
1 (WHITE-ON-BLACK) 



MA-9481 



Figure 4-2 Screen Mode 



Reset: ESC [ ? 5 I 

033 133 077 065 154 



The reset state causes the screen to be black with white (normal) charac- 
ters (Figure 4-2). 



Scroll Mode (DEC Private) (DECSCLM) 

Set: ESC [ ? 4 h 

033 133 077 064 150 

The set state causes smooth scrolling at a maximum rate of six lines per 
second. 



Reset: ESC [ ? 4 I 

033 133 077 064 154 

The reset state causes jump scrolling. 
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Character Sets and Selection 



Select Character Sets (SCS) 

The VT125 text mode can display 94 characters (one character set) at a 
time without using control functions. Using control functions to select the 
character sets allows the VT125 to display more than 94 different charac- 
ters on the screen. Characters are stored in up to five different character 
sets (some characters appear in more than one character set). The fol- 
lowing are the VT125 character sets. 

United States 

United Kingdom 

Special characters and line drawing 

Alternate ROM standard 

Alternate ROM special 

naj i c: i n& /H/remare? rsvivi is an upnunai itsmuie ui inv v i iuu teimniai 

KsUI lit KJllKSl DudlKJ. II CJ//CVVO IWVJ IIUJIC7 \sliai aisl&l 5tGl£> IW u^f icoiuCm in inc 

terminal, as compared with the graphics processor character sets that 
must be loaded for use. Refer to the VT100 Series Technical Manual for 
the specifications of this ROM. 

Tables 4-10 through 4-12 show the three standard VT125 character sets. 
Notice that the control characters and the Space and Delete characters 
are the same in all character sets. 

Any two VT125 character sets can be considered active at any one time. 
They can be invoked (selected) with single-character control functions if 
they are first designated by multiple character escape sequences. The 
two active character sets are designated by the computer as GO and G1 
using the Select Character Set (SCS) escape sequence. Once the char- 
acter sets are designated by the computer, a single control character is 
used to switch between the character sets. The Shift In (SI, octal 017) 
control character invokes the GO character set. The Shift Out (SO, 016) 
control character invokes the G1 character set. 



58 RECEIVED CHARACTER PROCESSING 



Table 4-1 UK Character Set 



87 


3 

B5 


O : 

o 


: 

:; '..:o\ ; >v ; v.. 
i 




• '0*- "■ ' 
1 

;■ ;• ' ti;i 




.;'••; 0; . 


'■:■''' '%■■-■' 1 •'. ' 







BITS 


COLUMN 




1 


/■;:■;' 2 : .--[ 


■• '•■3.',/ ; 


.r A ■■'■ 


••;•'••■'■• 5 V". 


;...•••• .•■6--. : ". ; . 


7 , 


B4 B3 B2B1 


ROW 








NUL 









20 
16 
10 


SP 


40 
32 
20 





60 
48 
30 


@ 


100 
64 
40 


p 


120 
80 
50 


■■■■*"'■■■ 


140 
96 
60 


;.••'.• 'P,:- ; ; 


160 
112 
70 


1 


1 




1 
1 

1 - 


DC1 

WON) 


21 
17 
11 


I 


41 
33 

21 ' 


1 


61 
49 

,31 


A 


TOT 
65 

41 


Q 


121 
81 
51 


''.■:•:■.■*■■.•;. 


141 
97 
61 


q 


161 

113 

71 


T 


2 




>:2" 
2 
2 


•"'.'■■,"•'•••.'•"• 


22 
18 
12 


If 


42 
34 
22 


2 


62 
50 
32 


B 


102 
66 
42 


R 


122 
82 
52 


'••■..,••*•:.;' 


142 
98 
62 


.V. T/',; 


162 
114 
72 


1 1 


3 




3 
3 
3 


DC3 

(XOFF) 


23 
19 
13 


£ 


43 

35 
23 


3 


63 

51 , 
33 


C 


W3 
67 

43, 


.";■ S'.. V 


123 
83 
53 


'■ ■.«•'•'' 


143 
99 
63 


';..■•;«,..; 


163 
115 
73 


1 


4 




4 
4 

4 




24 
20 

14 


$ 


44 
36 
24 


4 


64 
52 
34 


D 


104 
68 

: 44, 


••.'•■.f--; 


124 
84 
54 


d 


144 
100 

64 


■'.;.-t; ; .: 


164 
116 
74 


1 1 


•"5 ' 


ENQ 


5 

"'5. ; '' 
5 




25 
21 
15 


% 


45 
37 
25 


5 


65 
53 
35 


E 


.105;' 

69 
45 


u 


125 
85 
55 


'.';■« .. 


145 
101 
65 


u 


165 
117 
75 


1 1 


6 




6 
6 
6 




26 

22 
16 


& 


46 
38 
26 


6 


66 
54 
36 


F 


106 
70 
46 


V 


126 
86 
56 


f 


146 
102 
66 


V 


166 

118 
76 


111 


7 


BEL 


7 
7 
7 




27 
23 
17 


/ 


47 
39 
27 


7 


67 
55 
37 


G 


107 
71 
47 


w 


127 
87 
57 


9 


147 
103 
67 


w 


167 

119 

77 


10 


8 


BS 


10 
8 
8 


CAN 


30 
24 
18 


( 


50 
40 
28 


8 


70 
56 
38 


H 


110 
72 
48 


X 


130 
88 

58 


h 


150 
104 
68 


X 


170 
120 
78 


10 1 


9 


HT 


11 
9 
9 




31 
25 
19 


) 


51 
41 
29 


9 


71 
57 

39 


I 


111 
73 
49 


Y 


131 
89 
59 


j 


151 
105 
69 


y 


171 
121 
79 


10 1 


10 


LF 


12 
10 

A 


SUB 


32 
26 
1A 


* 


52 
42 
2A 


• 


72 
58 

3A 


J 


112 
74 
4A 


z 


132 
90 
5A 


J 


152 
106 
6A 


z 


172 
122 
7A 


10 11 


11 


VT 


13 
11 
B 


ESC 


33 
27 
1B 


+ 


53 
43 
2B 


» 


73 
59 
3B 


K 


113 
75 
4B 


C 


133 
91 
5B 


k 


153 
107 
6B 


{ 


173 
123 
7B 


110 


12 


FF 


14 
12 
C 




34 
28 
1C 


» 


54 
44 
2C 


< 


74 
60 
3C 


L 


114 

76 
4C 


\ 


134 
92 
5C 


1 


154 
108 
6C 


I 


174 
124 
7C 


110 1 


13 


CR 


15 
13 
D 




35 
29 
ID 


— 


55 
45 
2D 


ss 


75 
61 
3D 


M 


115 
77 
4D 


3 


135 
93 
5D 


m 


155 
109 
6D 


> 


175 

125 
7D 


11 10 


14 


SO 


16 
14 
E 




36 
30 

1E 


•. 


56 
46 
2E 


> 


76 
62 
3E 


N 


116 
78 
4E 


A 


136 
94 
5E 


n 


156 
110 
6E 


*>*■ 


176 
126 

7E 


1111 


15 


SI 


17 
15 
F 




37 
31 
IF 


/ 


57 
47 
2F 


? 


77 
63 
3F 


O 


117 
79 
4F 


— 


137 
95 
5F 





157 
111 
6F 


DEL 


177 
127 
7F 



KEY 



ASCII CHARACTER 



toVs 



33 


OCTAL 


27 


DECIMAL 


IB 


HEX 



Table 4-1 1 US Character Set 
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B7 
66 


B5 


n 


° 





, 





'->, 





1 , 


BITS 


COLUMN 




1 


2 


3 


4 


5 


6 


7 


84 B3 B2 B1 


ROW 








NUL 









20 

16 

Mil 


HH 


40 
32 
20 


nm 


GO 

48 


ins 


100 
64 
40 


IHii 


120 
30 
50 


i@$SS 


140 
96 
60 


SIB 


160 
112 


1 


1 




1 
1 


DC1 

ixorai 


us 

17 

Sill 


§§§§§j 


33 


HUB 


61 

49 

IIS 


IlilSSi 


101 
65 

III? 


Iji/ilii 


121 

S1 


a 


141 
97 

fill 


q 


161 
113 

II® 


10 


2 




? 

2 
2 




22 

i? 


ii 


34 
22 


igggi 


G2 
50 
32 


Bill 


6£. 

Mil 


iHl 


52 


Sii 


98 
62 


r 


16? 
7? 


11 


3 




|J3||J 
3 


iiill 

IXQFFi 


lis® 

19 

SHI 


# 


35 

MS 


3 


63 
51 
33 


C 


67 


HI 


f|g3j 
83 
53 


c 


tin? 

99 
63 


s 


163 
115 
73 


10 


4 




§8Ik 

4 

ftftl: 




24 

20 


$ 


36 

SHI 


4 


64 
52 

SB 


D 


104 
63 


T 


§111 


d 


SIS 

100 


t 


164 

116 
74 


10 1 


5 


ENQ 


5 

818 


^^^ 


25 
21 
15 


0/ 
/o 


fill 

37 

III! 


5 


53 


E 


69 

IS 


ii 


85 

55 


o 


101 
65 


n 


117 

S§£1 


110 


6 




6 




22 


& 


■16 
38 


6 


54 


F 


i fir, 
70 


V 


8(5 


fiiirpjf&Ufiivi 


102 


¥ 


118 

7^ 


MM%0i'i;l:0% 


7 


BEL 


SSI 




Slfi 

23 

17 


' 


39 

ISIS! 


7 


67 

55 


G 


71 

fill 


w 


1?/ 

37 

lt!8 


9 


147 
103 

Hit 


W 


119 
7/ 


10 


8 


BS 


8 


CAN ! g 


( 


40 


8 


70 
56. 

fill 


H 


f§§B 

72 

lift! 


lUtl 


88 

58 


h 


104 

IIS! 


X 


170 
120 


10 1 


9 


HT 


SKI 

9 




31 
25 


Hi 


Kill 

41 


9 


57 
39 


I 


HP! 

73 
49 


Y 


Mil- 

39 
59 


S 


105 
69 


y 


121 

MP 


10 10 


10 


LF 


SHI 

10 


SUB 


lilt 

26 
1A 


WfKSH 


42 


■ 


58 
3A 


J 


74 
4A 


Z 


90 


i 


106 

sis 


z 


?§if2| 
122 


10 11 


38 


VT 


13 

Bill 
B 


ESC 


33 

27 
18 


+ 


43 

1® 


HH 


SHI 
59 

ISlf 


fllKli 


Mi 

75 


C 


sag? 

9! 

SS§S 


k 


nit 

107 

lift 


{ 


123 


110 


12 


FF 


14 
12 

Hit 




34 
23 
1C 


• 


44 

Kit 


s 1 74 

^» i 60 


L 


WW 

76 
4C 


92 


1 


103 

ec 


1 


124 


SSSSi 


13 


CR 


Sii 

13 

3§lt 


I 


- 


45 
20 


= I 


Bit 


Wis? 

77 


J ' 93 

vsssssk 


m 


109 

SB 


> 


125 

iSif 


§i§ff|g|S|§ 


14 


SO 


ifif 

E 


I 


■ 


DPI 

46 


"^ | 62 


N 


SSI 

78 

life 


SKfltlfll 

5F 


n 


110 

Kit 


•«■*» 


i?6 

Mi 


llllsslil 


15 


CI 


3/ 

31 


/ 4,' 

?F 


O 77 

3F 





79 

SfSt 


— 


137 
95 

8&€ 


o 


6F 


DEL 


127 
7F 



KEY 



ASCII CHARACTER 



t\>V 



S3"- 


OCTAL 


27 


DECIMAL 


■fan 


HEX 
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Table 4-1 2 Special Character and Line Drawing Character Set 



■■.;-. 
Hi 


E5 


mi 


SflliSIl 







llflill 










HS 







MIS 


BITS 


COLUMN 




1 


liiilii 


3 


4 


5 


6 


IHIII 


64 63 B2 B1 


W$: 








NUL 








20 
16 
10 


SP 


32 





4S 


@ 


64 

sis 


P 


S2&3 
80 


im 


96 


SCAN 3 


112 


o "o 1 


Hit 






DC1 

(XON) 


21 

17 
11 


! 


33 

SI 


1 


49 

9lB 


A 


65 


}iM- : / 


W$: 
81 


8 


97 

SB 


SCAN 5 


113 
71 


10 


2 




2 




§2?R 
18 
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Mi© 


Sill 


Wsz/ 

50 

IS* 


iH? 


66 


,^ff; 


82 
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t 


98 
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#6® 
114 


1 I 


3 




3 


DC3 

(XOFF'l 
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19 

00 


%%$'■ 


35 

23 


: S$2 


61 


C 


67 
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83 
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99 
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115 


10 


4 








20 


P;$g 


/#$Y 
36 
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64 

52 
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104 
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44 


llill 


■:i-2*. :i 

84 

f54| 


!•!! 
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'0:/ 


116 
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5 
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21 


/■<&f/ : 


37 
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: Wi/ 
53 
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69 
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85 


f : ^ 
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65 


\M 
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22 
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& '"'• 


38 
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54 
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70 
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86 
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7 
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23 
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:.;<^/>:^j- 


47 

39 

27 


7 
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55 
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G 
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71 


w 
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87 
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67 
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77 


10 
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BS 
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8 
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50 

40 
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8 
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72 
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"' X'. ; 
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53 


I 
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104 
68 


" ■'■ [ h 


120 
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10 1 


9 


HT 


9 
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:3>1 ■ 


) 
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29 


SSf'l 
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57 
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■•:■% 


.1.11 . 
73 

: : ' ; 49'- : : 


Y 


131 
89 
59 


V 


151 
105 

: /Wi : - 


IS 


'ISM 

■'..' : ''79'' 


10 10 


10 


<-F 


'12/ 
10 

gill 


SUB 


32 
26 

1A 
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52 

.'42v 

2A 


llSllSlli 


72 
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.■; 3a - 


S^H 


■11:2 

/4 

:.4A : 


^i/. 


:'1'32. : 

90 


'vfe 


152 
106 
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IS 


172 


10 11 


11 


VT 


. 13. '■.. 
11 

.■:■■$'■■' 


ESC 


33 

■ '27.' 
IS 


lii||i 


. 53 
43 
26 
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3B 


K 
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■1H 


t 


133 
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5B 


1 


153 
107 

...6B: 
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123 

7B 


110 


12 
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14 
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34 
28 
\C 


» 


54 
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.<" 
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:.';';.3C ; - 


L 


114 
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4C 


\ 
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6l 
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7C 
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13 


CR 
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3 
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14 
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78 
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15 


SI 


17 

F 
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3f 
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4F 


(BLANK) 
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OF 
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/ 
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ASCII CHARACTER 
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33 


OCTAL 


27 
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ie 


HEX 
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The designated character sets are active until another Select Character 
Set (SCS) sequence is received. The GO and G1 character sets can be 
redesignated by the computer as often as needed using the SCS se- 
quence. The following sequences designate the VT125 GO character set. 



Select Character Set (SCS) 

ESC ( A 

033 050 101 

The above sequence designates the United Kingdom character set as 
GO. 



ESC ( B 

033 050 102 

The above sequence designates the United States character set as GO. 



ESC ( 

033 050 060 

The above sequence designates the special character and line drawing 
character set as GO. 



ESC ( 1 

033 050 061 

The above sequence designates the alternate ROM standard character 
set as GO. 



ESC ( 2 

033 050 062 

The above sequence designates the alternate ROM special character 
and line drawing set as GO. 
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The following sequences designate the VT125 G1 character set. 



ESC ) A 

033 051 101 

The above sequence designates the United Kingdom character set as 
G1. 



ESC ) B 

033 051 102 

The above sequence designates the United States character set as G1 



ESC ) 

033 051 060 

The above sequence designates the special character and line drawing 
character set as G1. 



ESC ) 1 

033 051 061 

The above sequence designates the alternate ROM standard character 
set as G1. 



ESC ) 2 

033 051 062 

The above sequence designates the alternate ROM special character 
and line drawing set as G1. 



The VT125 terminal also has a G2 and G3 character set. However, these 
character sets are always the United States (ASCII) character set. The 
G2 and G3 character sets can be selected for only one character at a 
time. The G2 and G3 character sets are selected using the single shift 2 
(SS2) and single shift 3 (SS3) sequences. The terminal returns to the pre- 
viously used character set after a single character is displayed. Select 
the G2 and G3 character sets for one character using the following se- 
quences. 
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Single Shift 2 (SS2) 

ESC N 

033 116 

The above sequence selects the G2 (ASCII) character set for one charac- 
ter. 



Single Shift 3 (SS3) 

ESC O 

033 117 

The above sequence selects the G3 (ASCII) character set for one charac- 



i ne unitea otates anu uuiteu ixinyuOin ocis i/umiumh lu mc i<jU huci- 
national register of character sets to be used with escape sequences." 
The other sets are private character sets. Special graphics means that 
the graphic characters for the codes 137(8) to 176(8) are replaced with 
other characters. The specified character set will be invoked by SI or SO 
until another SCS is received. Table 4-10 lists the US character set, Table 
4-1 1 lists the UK character set, and Table 4-12 lists the special character 
and line drawing character set. The VT125's US character set is a subset 
of the ASCII character set because in the VT125, only a few of the ASCII 
control characters have displayable forms. 

NOTE: The character set selected by SCS is only used by the text termi- 
nal. The graphics processor selects character sets with a ReGIS com- 
mand. 



Select Graphic Rendition (SGR) 

ESC [ Pn m default value: 
033 133 *** 155 

The above control function selects the character attributes. Character at- 
tributes are special display features that can be used (along with line at- 
tributes like double width) to make text on the screen appear special. All 
characters, transmitted to the VT125 after the SGR sequence, are dis- 
played with the selected attributes until the next SGR sequence clears or 
changes the attributes. 
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ESC [ m 

ooo hoo rten ice 



The above control function turns attributes off. 



ESC [ 1 m 

033 133 061 155 

The above control function makes the text bold (increases the intensity). 



ESC [4m 

033 133 064 155 

The above control function underlines text on the screen (Figure 4-3). 



ESC [ 5 m 

033 133 065 155 

The above control function causes the text on the screen to blink (Figure 
4-3). 



ESC [ 7 m 

033 133 067 155 

The above control function changes the text on the screen to a reverse 
(negative) image (Figure 4-3). 



All other parameter values are ignored. 

Without the Advanced Video Option, a character can have only one attri- 
bute, and the attribute can only be underline or reverse. Either 4 or 7 can 
be used in the control sequence, but the VT125 interprets the parameter 
as the attribute selected for the cursor in SET-UP. Refer to Cursor Selec- 
tion in the SET-UP Features chapter (Chapter 2). 



0S GR 
OFF ESC [0m 

0BOLD ESC [1M 
UNDERSCORE ESC[4m 
BLINK ESC[5M 

A REVERSE ESC[7m 
(BLACK-ON-WHITE) 

MA-9481 



Figure 4-3 Select Graphic Rendition 
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Scrolling 

Scrolling Region 

This is the area of the screen that can receive new characters by scrolling 
old characters off the screen either up or down. This area is defined by 
the top and bottom screen margins. The minimum size of the scrolling re- 
gion allowed is two lines, so the number of the top margin must be at least 
two less than the number of the bottom margin. The cursor moves to the 
home position when the margins are set. (Refer to Origin Mode on page 
55.) 



NOTE: Pt and Pb represent variable numeric parameters. The parame- 
ters are decimal numbers transmitted to the terminal as ASCII characters. 
Asterisks (***) represent one or more variable numeric parameters in the 
octal sequence. 

Set Top and Bottom Margins (DEC Private) (DECSTBM) 



ESC [ 

033 133 



Pt 



Pb 



073 



r 

162 



The above sequence sets the top and bottom margins to define the scroll- 
ing region (Figure 4-4). Parameter Pt is the line number of the top line in 
the scrolling region; parameter Pb is the line number of the bottom line in 
the scrolling region. Default is the complete screen (no margins). 

NOTE: Power up or reset causes the scrolling region to be the complete 
screen. 



A 



DECSTBM 

TOP MARGIN OF SCROLLING REGION 



ESC[Pt; Pb r (INCLUDES BOTTOM MARGIN) 



BOTTOM MARGIN OF SCROLLING REGION 



Figure 4-4 Set Top and Bottom Margins 
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Cursor Positioning 

The cursor indicates the location of the active position (Figure 4-5). This 
is where the next character appears. The cursor always moves one col- 
umn to the right when a character appears, and moves down one line 
when the terminal receives a linefeed. The cursor moves to the left margin 
when the terminal receives a carriage return. If a command tries to move 
the cursor past any margin, the action that will result is stated. The cursor 
moves to the home position (refer to Origin mode on page 55) when the 
top and bottom margins of the scrolling region are set and when origin 
mode is set or reset. Table 4-13 lists the sequences that move the cursor 
according to their parameters (all parameters have a default value of 1). 



r 



HOME (DECOM ESC[?61) 
CUP ESC[H 
HVPESC[f 



MEMORY 




COMPUTER 



HOME 

(DECOM ESC[?6h) 

CUPESC[H 

HVPESC[f 



DECRC \ V DECSC 

ESC 8 \ \ ESC 7 

\ \ CUU ESC[PnA 

\ \RI ESCM / 



CPR (SEE DECOM) 

ESC[P1; Pc R 

(INVOKED BY DSR ESC[6n) 




Figure 4-5 Cursor Positioning 
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Table 4-1 3 Cursor Positioning Commands 



Command 
Name 

Cursor 
up 



Cursor 
down 



Cursor 
forward 



Format 



ESC [ Pn A 



ESC [ Pn B 



ESC [ Pn C 



Mnemonic 
Function 

This command moves the cursor Pn lines 
up in same column. Cursor stops at the 
top margin. 

This command moves the cursor down 
Pn lines in same columa Cursor stops at 
the bottom margin. 

This command moves the cursor Pn 
columns to the right. Cursor stops at the 
right margin. 



cursor 
backward 



Cursor 
position 



too i rn u 



ESC [ PI ; Pc H 



This command moves the cursor Pn 
columns to the ieft. Cursor stops at the 
left margin. 

This command moves the cursor to line 
PI, column Pc. Default value for either 
moves the cursor to the first line or 
columa respectively; for both, to home. 
For PI or Pc outside margins, cursor stops 
at the nearest margin. 

The numbering of lines depends on origin 
mode. In the VT1 25, this control acts like 
the horizontal and vertical position 
control. 



Horizontal 
and vertical 
position 



Cursor 

position 

report 



ESC [ PI ; Pc f HVP 

This command moves the cursor to line 
PI, column Pc. Default value for either 
moves the cursor to the first line or 
column, respectively. When the default 
value is used for both parameters, the 
cursor moves to home position. For PI or 
Pc outside margins, cursor stops at near- 
est margin. 

The numbering of lines depends on origin 
mode. In the VT1 25, this control behaves 
identically with cursor position. 

ESC [ PI ; Pc R CPR 

This command is requested by 

DSR ESC I 6 n from the host. Refer to 

the Reports section of this chapter 
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Tnkln 4..40 ^..«^-._ P»-._:i:__:_ _ *» ■_ # « _ .. n 

■"""'■ , ■ »» vmiwvi ■ wdiiiuiiiii;) wuiimiaiiuo \v*uillj 



Command 
Name 



Format 



Mnemonic 
Function 



Index 



ESC D 



Reverse 
index 



Next 
line 



ESCM 



ESC E 



Save 
cursor 
(DEC Private) 



l||i||§i^;;^|l|| 
cursor 
(DEC Private) 



ESC 7 



ESC 8 



This command moves the cursor down 
onelineinsamecolumn. If the cursor is at 
the bottom margin, a scroll up is per- 
formed. 

This command moves the cursor to the 
same horizontal position on the preced- 
ing line. If the cursor is atthe top margin, a 
scroll down is performed. 

This command moves cursor to the first 
position on the next line down. If the 
cursor is at the bottom margin, a scroll up 
is performed. 

■:;T^€CSCq0 

This command saves the cursor position, 
graphic rendition (character attribute), and 
character set in terminal mernory. (Refer 

DECRC ';■:■:.■-: '..JS-^f^-^i'^^'j 
this command restores the previously 
saved cursor position, graphic rendition 
(character attribute), and character set. If 
none was saved the cursor moves to the 
top left home position (line 1, column 1) 
regardless of origin mode. 
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Tabs 



Tabs are positions selected on the horizontal lines of the screen (Figure 
4-6). The cursor advances (tabs) to the tab stops when the terminal re- 
ceives an HT (octal 011) control character. Each control character ad- 
vances the cursor to the next tab stop. If no tabs are set, any HT charac- 
ter moves the cursor to the right margin. 



Horizontal Tabulation Set (HTS) 

ESC H 

033 110 

The above sequence sets one horizontal stop at the cursor position. 



Tabulation Ciear (TBC) 

ESC [ g 

033 133 060 147 

The above sequence clears the horizontal tab stop at the cursor position 
(default). 



ESC [ 3 g 

033 133 063 147 

The above sequence clears all horizontal tab stops. 




Figure 4-6 Tabs 
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Line Attributes 



Line attributes are special display features of the VT125 that affect a 
complete line at a time. Only the line containing the cursor is affected. 
The cursor stays in the same character position unless it would be to the 
right of the right margin, in which case it moves to the right margin. 



Double-Height Line (DEC Private) (DECDHL) 



Top Half: 




Bottom Half: 


ESC # 


3 


ESC # 4 


033 043 


063 


033 043 064 



These sequences cause the line including the active position to become 
the top or bottom half of a double-height double-width line (Figure 4-7). 
The sequences must be used in pairs on adjacent lines and the same 
character output must be sent to both lines to form full double-height char- 
acters. If the line was single-width single-height, all characters to the right 
of the center of the screen are lost. 



Double-Width Line (DEC Private) (DECDWL) 

ESC # 6 

033 043 066 

The above sequence causes the line that includes the active position to 
become double-width single-height. If the line was single-width single- 
height, all characters to the right of the center of the screen are lost. 



Single-Width Line (DEC Private) (DECSWL) 

ESC # 5 

033 043 065 

The above sequence causes the line that includes the active position to 
become single-width single-height. This is the default condition for all new 
lines on the screen. 



AB 



TOP HALF ESC #3 
DECDHL H f\ BOTTOM HALF ESC #4 



DECDWL HS ESC #6 

DECSWL AB ESC #5 

MA-9481 

Figure 4-7 Line Attributes 
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Erasing 

Erasing removes characters from the text memory of the VT125 (Figure 4- 
8). When characters are erased from the text memory, they are lost. Any 
complete line erased by Erase in Display has its line attribute set to 
single-height, single-width. Erasing does not change the number of col- 
umns per line. 



Erase In Display (ED) 



ESC [ 

033 133 



Pn 

* * * 



J default value: 
112 



The above sequence erases some or all of the characters in the display 
according to the parameter. Any complete line erased by this sequence is 
aiven a line attribute for single-height, single-width. 



ESC [ J or 

033 133 112 



ESC [ J 

033 133 060 112 



Either of the above sequences erases from the cursor to the end of the 
screen. 




Figure 4-8 Erasing 
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ESC [ 1 J 



The above sequence erases from start of the screen to the cursor. 



ESC [ 2 J 

033 133 062 112 

The above sequence erases all of the display - all lines are erased, 
changed to single-width, and the cursor does not move. 



Erase In Line (EL) 

ESC [ Pn K default value: 
033 133 *** 113 

The above sequence erases some or all characters in the active line ac- 
cording to the parameter. Erasing does not change line attributes. 



ESC [ K or ESC [ K 

033 133 113 033 133 060 113 

Either of the above sequences erases from the cursor to the end of the 
line. 



ESC [ 1 K 

033 133 061 113 

The above sequence erases from the start of the line to the cursor. 



ESC [ 2 K 

033 133 062 113 

The above sequence erases all of the line. 
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VT125 Communication and Graphics 
Protocol Controls 



The VT125 uses an ANSI protocol called the Device Control String to con- 
trol its graphics and some of its communications. A control string is a 
group of characters that have a clearly marked beginning and end and are 
understood by a device as a unit for control purposes. The device control 
string is made of an introducer, followed by data, followed by a terminator. 
The introducer (ESC P) tells the VT125 that the characters that follow are 
parameter information about which graphics protocol is coming (ReGIS, 
DECwriter, or VT105) and where the protocol data should go (to the host, 
the auxiliary port, or the video screen). The rest of the string is graphics 
data in the specified protocol, followed by the string terminator (ESC \). 
The string terminator returns the VT125 to its text operation. When a de- 
vice control string begins, the VT125 can not understand another device 
control string command until the first one is terminated by the string termi- 
nator characters. 



Device Control String (Introducer) (DCS) 

ESC P 

033 120 

The above sequence is the introducer to the commands that control the 
VT125's internal protocols. When the VT125 receives this sequence from 
one of its data paths, it looks at that same data path for one or two more 
characters to select the operation, as listed below. Refer to the Commu- 
nications chapter (Chapter 7) for an explanation of the data path. 



Device Control String Parameters 



ESC 


P 


P 


or 


ESC P 





P 


033 


120 


160 




033 120 


060 


160 



Either of the above sequences tells the VT125 to enter ReGIS, accepting 
data from the same data path as this sequence, at the command level 
that was in effect at the end of the last ReGIS device control string. 
(ReGIS is at the highest command level if the terminal was reset after the 
last device control string.) 
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ESC P 



The above sequence tells the VT125 to enter ReGIS, accepting data from 
the same data path as this sequence, and force immediate synchro- 
nization to the highest command level in the same way that the ";" char- 
acter acts in a ReGIS command string. The semicolon is explained in the 
ReGIS Graphic Programming chapter (Chapter 7). 



ESC P 2 p 

033 120 062 160 

The above sequence tells the VT125 to enter ReGIS according to p (al- 
lowing completion of previous commands) and also send the ReGIS text 
to the data path that was previously selected. (This typically is the host to 
VT100 data path and allows the simultaneous display of both the graphics 
and the ReGIS text that creates the graphics.) 



ESC P 3 p 

033 120 063 160 

The above sequence tells the VT125 to enter ReGIS according to 1 p (im- 
mediate synchronization) and also send the ReGIS text to the data path 
that was previously selected. (This typically is the host to VT100 data 
path and allows the simultaneous display of both the graphics and the 
ReGIS text that creates the graphics.) 



NOTE: Asterisks (***) represent variable numeric parameters in the oc- 
tal sequence. 



Delimit Image Format 

ESC P Pn q 

033 120 *** 161 

The above sequence tells the VT125 to accept the text that follows from 
the same data path as this sequence as DECwriter graphics hardcopy 
descriptor and display it. Pn is ignored. Refer to the Media Copy control 
function description for information about generating DECwriter descrip- 
tor. 
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Enter VT105 Emulator Mode 

ESC P Pn t 

033 120 *** 164 

The above sequence tells the VT125 to accept the text that follows from 
the same data path as this sequence as VT105 commands to be exe- 
cuted by the VT125. The parameter is ignored and may be omitted (but if 
included, should be for compatibility with future sequences). The VT105 
emulator does not have the simultaneous text display capability of ReGIS. 



String Terminator (ST) 
ESC \ 

UOO I Ot 

The above sequence enas me siring oi uaia emu iciumo mo v ■ ,^ ^ i^~.. 
mode. 



NOTE: Ps represents a variable parameter selected from a list of param- 
eters. Asterisks (***) represent the parameter in the octal sequence. 



Media Copy (MC) 

ESC [ Ps i 

033 133 *** 151 

Media Copy selects the connections between the different ports of the 
VT125. There are two classes of parameters (Ps) understood by this se- 
quence: ANSI standardized and DIGITAL private. Standardized and pri- 
vate parameters can not be in the same sequence. More than one param- 
eter from a class can be in each sequence, using the semicolon syntax for 
multiple selective parameters (Ps;...;Ps). The VT125 does not accept a 
sequence that turns off all output paths. Therefore, turn on the auxiliary 
port before turning off the screen. Refer to the explanation of ports start- 
ing on page 194 for more information. 



ANSI Parameters 

ESC [ 4 i 

033 133 064 151 

The above sequence turns off copying of data from the host computer to 
the auxiliary port. 
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ESC [ 5 i 

OOQ lOO OCC 1CH 



The above sequence turns on copying of data from the host computer to 
the auxiliary port. 



ESC [ 6 i 

033 133 066 151 

The above sequence turns off copying of data from the host computer to 
the text screen. 



ESC [ 7 i 

033 133 067 151 

The above sequence turns on copying of data from the host computer to 
the text screen. 



Private Parameters 

ESC [ ? i 

033 133 077 060 151 

The above sequence selects the auxiliary port as the destination for 
DECwriter descriptor data containing the contents of the graphics mem- 
ory as controlled by the S(H) option in ReGIS. Usually used to produce a 
hardcopy of the screen on an LA34-VA. This is the default condition when 
using the ReGIS protocol. 



ESC [ ? 2 i 

033 133 077 062 151 

The above sequence selects the host computer as the destination for 
DECwriter descriptor data containing the contents of the graphics mem- 
ory as controlled by the S(H) option in ReGIS. It is usually used to store a 
file of DECwriter descriptor on the host com n uter for later transmission to 
an LA34-VAor VT125." 
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Reports 

Reports are transmitted by the VT125 in response to requests from the 
computer or other device. Reports are used to determine the cursor posi- 
tion, type of terminal, and the operational status of the terminal. The fol- 
lowing sequences are the requests for reports and the reports generated. 



Cursor Position Report 

ESC [PI ; Pc R 

033 133 *** 073 *** 122 

The above report is requested by a Device Status Report (DSR) sequence 
(ESC [ 6 n). The terminal reports the active position with the CPR se- 
quence. This sequence has two parameter values, the first specifying the 

Una ons-l tine* c*£\f*r\nri on>c±r*if\i\r\rt tho onlumn Tho H of q i lit nrinHitinn uuith nn 

lilies C&l IVJ IIIU %?\^V/VXI IW \JfS\* Wll J ■■ IJJ II IV Wwi*«i i ■■ ■- ■ iiv ^wimmi* vwi i M >...v ■ ...%.. . ■•». 

parameters present, or parameters of 0, indicates the cursor at home po- 
sition. The numbering of lines depends on the setting of origin mode. 



Device Attributes (DA) 

ESC [ Pn c default value: 
033 133 *** 143 

Request: 

ESC [ c or ESC [ c 

033 133 143 033 133 060 143 

A device asks the VT125 to identify itself by sending the DA control se- 
quence with either no parameter or a parameter of 0. 

Response: ESC [ ? 1 2 ; <VT100 features> ; 
<VT125 features > ; 
<VT125 ROM version> c 

The VT125 responds to the DA request with a DA sequence having nu- 
meric parameters only on the same data path from which the request 
came. 



? 1 2 

077 061 062 

This part of the sequence is the DIGITAL private identifier for the VT125. 
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<VT100features> 



This part of the sequence is 5 if no advanced video option is installed, or 
a 7 if an advanced video option is installed. The VT125 checks the VT100 
with an internal DA swap during power up or reset. 



<VT125features> 

This part of the sequence is a 1 if a printer is connected to the auxiliary 
port, or a if nothing is connected to the auxiliary port. The VT125 checks 
for a printer by reading the EIA DSR pin during power up or reset. Only 
printers that drive DTR can be detected. 



<VT125 ROM version> 

This number indicates the firmware revision level of the VT125 graphics 
processor code. 



Identify Terminal (DEC Private) (DECID) 

ESC Z 

033 132 

The above sequence causes the same response as device attributes if 
the terminal is in ANSI mode. (Refer to VT52 Reports in this chapter.) This 
sequence will not be supported in future DIGITAL terminals; therefore, any 
new software should use Device Attributes. 
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Device Status Report (DSR) 

NOTE: Ps represents a variable parameter selected from a list of param- 
eters. Asterisks (***) represent the parameter in the octal sequence. 

ESC [ Ps n default value: 
033 133 *** 156 

The above sequence requests the general status of the VT125 with the 
following sequences. 



Requests 



ESC [ 5 n 

033 133 065 156 

Command from computer - Report status of the VT125 on the same data 
path that the request came on with the following sequences. 



ESC [ 6 n 

033 133 066 156 

Command from computer - Report active position (using a cursor position 
report control sequence) 



Responses 



ESC [On 

033 133 060 156 

Response from VT125 - Ready, no malfunctions detected (default) 



ESC [ 3 n 

033 133 063 156 

Response from VT125 - Malfunction - soft error -reset and retry 

DSR with a parameter value of or 3 is always sent as a response to a 
requesting DSR with a parameter value of 5. 
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Reset 



Reset To Initial State (RIS) 

ESC c 

033 143 

The above sequence resets the VT125 to its initial state. This is the state 
it has after it powers up, performs the internal self-test, and reads the 
SET-UP information in the user permanent SET-UP feature memory. 

NOTE: When the terminal is reset, cursor key mode and origin mode are 
reset, keypad numeric mode is selected, and the top and bottom margins 
of the scrolling region are set to be the complete screen. Any graphics 
protocol selection and the graphics memory are cleared and the graphics 
processor returns to text mode. 



RECEIVED CHARACTER PROCESSING 81 



Tests and Adjustments 

The VT125 has many tests that are performed to be sure the terminal is 
running properly. Also, a pattern for screen alignment is provided. All 
DECTST sequences have an effect on the communication port (Table 7- 
1). Refer to the Maintenance and Troubleshooting chapter (Chapter 9) for 
the meanings of displayed error codes. 



Screen Alignment Display (DEC Private) (DECALN) 

ESC # 8 

033 043 070 

The above command fills the entire screen area with uppercase Es for 
screen focus and alignment (Figure 4-9). This command is used by 
DIGITAL manufacturing and Field Service personnel. 



invoke Confidence Test (DECTST) 

If the first parameter of the sequence is 2, the VT125 tells the VT100 to 
perform its self-tests according to the numeric parameter. Table 4-14 lists 
the VT100 tests. If the first parameter of the sequence is 4, the VT125 
performs its own self-tests according to the selective parameters that fol- 
low the 4. Table 4-15 lists the VT125 tests. Refer to the Maintenance and 
Troubleshooting chapter (Chapter 9) for explanations of the tests' ac- 
tions. 

NOTE: Be sure that these sequences get transmitted correctly because 
some wrong sequences do not give any indication of error. 



E E E E E 

E E E E E 

E E E E E 

E E E E E 



DECALN 
ESC #8 



Figure 4-9 Screen Alignment Display 



82 RECEIVED CHARACTER PROCESSING 



VT100 Self-Test Format: ESC [ 2 ; Pn y 

Sequence Meaning 

NOTE: Do not use VT100 loopback tests with the graphics processor installed. 
Loopback tests require test connector. Continuous tests end at failure or 
power-off. 

ESC [ 2 ; 1 y VT100 resets and performs power-up test it also causes 

VT1 25 power-up self-test. 

ESC [ 2 ; 3 y This is the VT1 00 power-up and data loopback tests. 

ESC [ 2 ; 4 y This is the VT1 00 EIA modem control loopback test. 

ESC [ 2 ; 5 y This is the VT1 00 power-up and EIA modem control loopback 

p ; p:;p;p^^p|:f:||^s. 

ESC f 2 ; 6 y ; : ;'Th^-%i^en^s- : thfi!'VT1 00 data loopback and £)A modem 

■;4--' ■ controi16opbaok;testa" : ::;:;\:-^, 'u ; :,':.';^£ ; 

ESC 1 2 ; 7 y : This sequence ^ is the VT1 00 power-up, data loopfeack and;EIA 

ESC [2 1 8 y , ' .'■ : Reserved Do hot usa ■. .^ 



ESC[2 


1 9 Y 


This sequence causes the VT1 00 power-up test to repeat: 
continuously until failure or power off. This sequence is not 
■ usable while; graphics processor is installed. 


ESC [ 2 


;10y 


This sequence causes the VT100 data loopback test to repeat 

!i|i!!w^ 


ESC [ 2 ; 


. 11 y 


Thiss^ 


ESC [ 2 ; 


12y 


: :;^Thjs;sefMehee:<^M^ 
||;iep|o^pejit -cpnfe 


ESC [ 2 ; 


13y 


;;|;|fsfeto;riep^^ 








ESC [ 2 ; 


14 y 


||f^is|seqjj;en^ 








ESC [ 2 ; 


15y 


l ; !;;T|i^sl|q^^ 






and EIA modem control loopback tests to repeat continuously 
until failure or power off. 
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Table 4-1 5 VT1 25 Self-Tests 

1 . Test parameters may appear in the sequence in any order, but they always run 
in increasing numerical order. Always include the power-uptest parameter for 
correct display of error indications. 

2. Refer to Operator Maintenance and Troubleshooting (Chapter 9) for the 
meanings of displayed error codes. 

Ps = 2 VT1 25 Computer port data loopback test 

Ps = 3 VT1 25 Auxiliary port data loopback test 

Ps = 5 VT1 25 Video bit map memory test 
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Indicators 



Keyboard Indicators 

The keyboard has seven indicator lights that are light emitting diodes 
(LEDs). The ON LINE and LOCAL indicators light to indicate the commu- 
nication status of the terminal. If the keyboard is connected and power is 
on, either the ON LINE or the LOCAL indicator is on. 

The KBD LOCKED indicator lights to show the keyboard locked condition, 
in this condition the keyboard transmit buffer is full and cannot accept 
characters from the keyboard. 

The L1 through L4 indicators are programmable and can be assigned any 
meaning for specific applications. The following sequences turn these in- 
dicators on or off. 



Load LEDs (DEC Private) (DECLL) 

NOTE: Ps represents a variable parameter selected from a list of param- 
eters. Asterisks (***) represent the parameter in the octal sequence. 

ESC [ Ps ; Ps ... Ps q default value: 
033 133 *** 073 *** * * * 161 

The above sequence loads the four programmable indicators on the key- 
board according to the parameter(s). 



Sequence Meaning 

ESC [ q Clear indicators 1 through 4 

ESC [ 1 q Light indicator 1 

ESC[2q Light indicator 2 

ESC[3q Light indicator 3 

ESC[4q Light indicator 4 

Indicator numbers are marked on the keyboard. 



RECEIVED CHARACTER PROCESSING 85 



VT52 COMPATIBLE SEQUENCES 

The sequences compatible with the VT125 and VT52 meet private 
DIGITAL standards. Therefore, the VT125 can use existing software 
designed for previous terminals (such as the VT52), but only for text appli- 
cations. The graphics processor cannot operate with VT52-compatible 
sequences. VT52 compatibility is selected from the keyboard in SET-UP 
(refer to Chapter 2) or by the computer using a sequence (refer to the 
ANSI-compatible sequences on page 51). 
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VT52 MODES 



SET-UP FEATURE AND MODE SELECTION 

While in VT52 mode, sequences cannot be used to select most VT125 
SET-UP feature selections. However, the following three modes can be 
selected using sequences. 

1. ANSI mode 

2. Alternate keypad mode on 

3. Alternate keypad mode off 

Enter ANSI Mode 

ESC < 

033 074 

All subsequent escape sequences are understood according to ANSI 
Standards X3.64-1979 and X3.41-1974. The VT52 escape sequences 
shown in this section are not recognized. 



Alternate Keypad Mode On 

ESC = 

033 075 

The auxiliary keypad keys send uniquely identifiable escape sequences 
for use by applications programs. Table 4-16 lists these codes and se- 
quences. 



Alternate Keypad Mode Off 

ESC > 

033 076 

The auxiliary keypad keys send the ASCII codes for the functions or char- 
acters on the keys. 
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Table 4-1 6 


VT52 Mode Auxiliary Keyr. 


>ad Codes 




Alternate 


Alternate 




Keypad 


Keypad 


Key 


Mode Off 


Mode On 





fSSs^g^figi^giBi 


ESC ? p 


iillSlif; 


W^^^^S^S^^^K^SB 


ESC ? q 


2 


s||^i|ii|||||i||l|Slli 


ESC ? r 


3 


^^^^^^^^^S^^^^M 


ESC?s 


4 


i!^SmiSSSS$SttS 


ESC ? t 


5 




ESC?u 


6 


iiililillililiiSlili 


ESC?v 


;ilil§li;l| 


^^^^^^^^^^^^^^s 


ESC?w 


8 


W^^BM^Sil90^MM&ii 


ESC ? x 


9 


9 


ESC ? y 


-(minus) 


- (minus) 


ESC?m 


, (comma) 


, (comma) 


ESC ? 1 


. (period) 


. (period) 


ESC?n 


ENTER 


Same as RETURN key 


ESC ? M 


PF1 


r-r><-» r-> 


ESC P 


PF2 


ESC Q 


ESC Q 


PF3 


ESC R 


ESC R 


PF4 


ESC o 


ESC S 
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VT52 CHARACTER SETS AND SELECTION 



While in VT52 mode, the VT125 can use either the character set selected 
in SET-UP B or the VT125 Special Character and Line Drawing character 
set. The following sequences select the character sets. 



Enter Graphics Mode 

ESC F 

033 106 

The above sequence causes the special graphics character set to be 
used. 

NOTE: The special graphics characters in the VT125 are different from 
those in the VT52. Refer to Table 4-17. 



Exit Graphics Mode 

ESC G 

033 107 

The above sequence causes the standard ASCII character set to be used. 
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Table 4-1 7 Special Characters and Line Drawing Set 
and Graphics Mode Comparison 



Octal 
Code 


US/UK 
Set 


Special Characters 
and Line Drawing Set 


VT52 in 
Graphics Mode' 


137 


ilililllllii 


: MV:lUvR;;~;' 


Blank 


Blank 


140 


liBiin 


fill 


Diamond 


Reserved 


141 


Iliiillilllli 


fill 


Checkerboard 
(error indicator) 


Solid rectangle 


142 


B^^H 


alt 


Horizontal tab 


^flBi^BSB 


143 


9SS§ 


* 


Form feed 


iSlRKiR-^-n 


144 


1^^^ 


** 


Carriage return 


I^BB^BSI 


145 


I^^Bi 


"f 


Linefeed 


liSSSiSft^ 


146 


^^^B 





Degree symbol 


Degrees 


147 


tMSS^ 


i 


Plus/minus 


Plus or minus 


150 


ISBSlis 


liBS 


New line 


Right arrow 


151 


^^Bi 


T 


Vertical tab 


Ellipsis (dots) 


152 


111111 


Bill 


Lower- right corner 


Divide by 


153 


tt€!8i 


11111 


Upper-right corner 


Down arrow 


154 


i^^^B 


|Jg4 


Upper-left corner 


Bar at scan 


155 


m 


l 


Lower-left corner 


Bar at scan 1 


156 


IllBilllili 


iti 


crossing lines 


Bar at scan 2 


157 


Hljlllllllll 


BKSiBft 


Horizontal line- scan 1 


Bar at scan 3 


160 


SBBBB 


111111 


Horizontal line- scan 3 


Bar at scan 4 


161 


lisiiiii 


lfi§fl 


Horizontal line - scan 5 


Bar at scan 5 


162 


iilliS 


liliti 


Horizontal line - scan 7 


Bar at scan 6 


163 


BIBB 


msii 


Horizontal line - scan 9 


Bar at scan 7 


164 


lillllB 


|||§ 


Left"r 


Subscript 


165 


|il||||||ij|| 


\ 


Right "T" 


Subscript 1 


166 


i^^BI 


Bill 


Bottom "T' 


Subscript 2 


167 


w 


illS 


Top'T' 


Subscript 3 


170 


lllliliillll 


S1S1I 


Vertical bar 


Subscript 4 


171 


Sfllfltf 


l§lftlv 


Less than or equal to 


Subscript 5 


172 


|||lli||||||il|l| 


:^V.V."; : '^_::;:!: 


Greater than or equal to 


Subscript 6 


173 


T:WSM 


liil 


S||8|llllllflSSIR|Sil-I 


Subscript 7 


174 


illllill 


^ 


Not equal to 
UK pound sign 


Subscript 8 


175 


1B1IB 


i 


Subscript 9 


176 


IlSIiilllillll 


• 


Centered dot 


Paragraph 



* Not available in VT1 25 
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VT52 CURSOR POSITIONING 



The cursor indicates the location of the active position. This is where the 
next graphic character appears. The cursor always moves one column to 
the right when a graphic character is displayed, and moves down one line 
when a linefeed is received. The cursor moves to the left margin when a 
carriage return is received. If a command tries to move the cursor past 
any margin, the action that will result is stated. The VT52 mode margins 
are always the top and bottom of the display screen. Table 4-18 lists the 
sequences that move the cursor according to the sequence's parame- 
ters. 



Table 4-1 8 VT52 Cursor Positioning 

Sequence Format Result 

Cursor up ESC A The cursor moves up one line in same column. 

Cursor stops at the top of the screen. 

Cursor down ESC B The cursor moves down one line in same 

column. Cursor stops at the bottom of the 
screen. 

Cursor right ESC C The cursor moves one column to the right. 

Cursor stops at the right margin. 



Cursor left ESC D The cursor moves one column to the left. 

Cursor stops at the left margin. 



Cursor to home ESC H 



The cursor moves to the home position at line 
1, column 1. 



Reverse line ESC I The cursor moves up one line in the same 

feed column. If the cursor is at the top margin, a 

scroll down is performed. 



Direct cursor ESC Y PI Pc The cursor moves to the specified line and 
address column. The line and column numbers are sent 

as the ASCII characters whose codes are the 
decimal numbers plus 31 ; for example, 32(1 0) 
(SPACE) refers to the first line or column, and 
1 11(10) refers to the eightieth column. 
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VT52 ERASING 

Erasing removes characters from the screen of the VT125. When charac- 
ters are erased from the screen, the characters are lost. The following se- 
quences erase characters from the screen. 

Erase to End of Screen 

ESC J 

033 112 

The above sequence erases all characters from the cursor to the end of 
the screen. The cursor does not move. 

Erase to End of Line 

ESC K 

033 113 

The above sequence erases all characters from the cursor to the end of 
the current line. The cursor does not move. 
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VT52 REPORTS 

The VT125 generates only one report in VT52 mode. 

Identify 

ESC Z 

033 132 

The above sequence causes the terminal to send its identifier escape se- 
quence to the computer. 

The response is ESC/Z. 

NOTE: This is the VT52 response. 
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Figure 4-10 is a one-page summary of the ANSI mode display control 
functions. 



HOME (DECOM ESC[?6D 
CUP ESC[H 



HVP ESC[f 



DECRC \ 
ESC 8 \ 



MEMORY 

r 




CPR (SEE DECOM) 

ESC[P1; Pc R 

(INVOKED BY DSR ESC[6n) 



DECSC 
ESC 7 



DECSTBM 

TOP MARGIN OF SCROLLING REGION 




HOME 
(DECOM ESC[?6h) 
CUPESC[H 
u\/p per ff 



\ v CUU ESC[PnA > 

\ \RI ESCM / 

\ \ T / 



ESC[Pt; Pb r (INCLUDES BOTTOM MARGIN) 



CUB 
ESC[PnD' 



I 



*ESC[PnC 



-INtL tbU t- 



CUD ESC[PnB 



^ CUP ESC[P1; Pc H 
A— iHVP ESC[Pl:Pcf 



U 



(SEE DECOM) 




EL 
ESC[1K" 



ERASE IN LINE 
EL 



■ 4* 



"ESC[2K 



BOTTOM MARGIN OF SCROLLING REGION 



NOTE: 
1 =ONE 

1 = LOWERCASE L 
I = UPPER CASE i 



| TBC 
I ESC[0g 



V: 



DECDHL 



AB 



TOP HALF ESC #3 
BOTTOM HALF ESC #4 



DECDWL AB ESC #6 
DECSWL AB ESC #5 



El 



E E E E E 

E E E E E 

E E E E E 

E E E E E 



DECALN 
ESC #8 



SGR 

OFF ESC [0m 

BOLD ESC[1M 
UNDERSCORE ESC[4 m 
BLINK ESC[5M 

REVERSE ESC[7m 
(BLACK-ON-WHITE) 



DECSCNM-SCREEN 

\ REVERSE ESC [?5h 
H (BLACK-ON-WHITE) 



DESIGNATION: G0 



G1 



El 



NORMAL ESC [?51 
(WHITE-ON-BLACK) 



INVOKED BY: SI: CTRL/O SO: CTRL/N 

U.K. ESC(A ESOA 

U.S. ESC(B ESOB 

GRAPHICS ESC(0 ESO0 

ALT ROM ESC(1 ESC)1 

ALT SPECIAL ESC(2 ESC)2 

• DECANM 

ANSI mode (from VT52) ESC < 

VT52mode (from ANSI) ESC[?21 

• DECARM 

autorepeat ESC[?8h 

no autorepeat ESC[?81 

• DECAWM 

autowrap ESC[?7h 

no autowrap ESC[?71 



DECCKM-Cursor Keys 




application 


ESC[?1h 


cursor control 


ESC[?11 


DECCOLM 




132 column 


ESC[?3h 


80 column 


ESC[?31 


DECPAM 




keypad application 


ESC = 


DECPNM 




keypad numeric 


ESC> 


DECOM-Origin Mode 




relative 


ESC[?6h 


absolute 


ESC[?61 


DECSCLM 




smooth scroll 


ESC[?4h 


jump scroll 


ESC[?41 



Figure 4-10 VT125 ANSI Mode Display Control Functions 



ReGIS GRAPHIC 
PROGRAMMING 



INTRODUCTION 

This chapter explains the Remote Graphics Instruction Set (ReGIS) for the 
VT125 graphics processor. With the information in this chapter, a pro- 

rirrtfnivirtr Aon r\r^r\^r& imft/ioe $/"*■* i"l I G r*i I Q w r\r\ 4-lArt \/TiQC in + Amol rY\s\r\l+s\r /\r 

yiaiiiinoi widn picpdic iniayco iui uiopicijf v/u n 10 v i i l«3 niiciiidi invjiiiiui »_»i 

a connected color monitor, or print the images on a DECwriter graphics 
printer. 

DEFINITIONS 

ReGIS is a graphics descriptor. A graphics descriptor is a symbol system 
that describes the parts of an image. An image is a type of information 
that people understand by seeing and relating it to familiar visual images. 
An image (graphic) is the best way to communicate some types of infor- 
mation. The problem for a graphics descri n tor is to describe the ima n e 
with as few symbols as possible to save storage space and commu- 
nication line time. ReGIS works by considering an image to be a group of 
graphic objects. Each graphic object is a standard geometric form that 
can be described with a few characters of information. For example, 
ReGIS understands that the form of a circle applies to any circle that can 
be drawn. A circle can be described on the screen by the location of its 
center and a point on its circumference. The same type of understanding 
for other graphic objects lets ReGIS describe graphics images with short 
commands. 

VT125 ReGIS is one implementation of a graphics instruction set de- 
signed at DIGITAL. Details of ReGIS may differ from one ReGIS device to 
another, depending mostly on the hardware's capabilities. For example, 
refer to Appendix F which lists differences between the VT125 and the 
VK100 (GIGI). 

Each graphic object is made of a group of the smallest units of information 
on the screen. These units are pixels. Pixel size is determined by both the 
minimum size of unit that the monitor can display, and by the maximum 
number of units that the graphics processor can address and store. If a 
device can display more pixels than another, it is has higher resolution 
than the other. The VT125 graphics processor can display 184,320 pixels 
in a 768 X 240 array and is considered a medium resolution device. The 



95 



96 ReGIS PROGRAMMING 



graphics processor's memory can store 196,608 pixels in a 768 X 256 x 
2 array. The display of the VTi25 is a window that looks into tnis memory. 
The window can move in any direction with a Screen command to display 
all parts of the pixel memory, or to move an object in the image to the 
center of the display. 

ReGIS SYNTAX 

The VT125 graphics processor command syntax is a Device Control 
String (DCS) introducer sequence (ESC P), followed by protocol selection 
characters, followed by any number of characters in the selected pro- 
tocol, followed by the String Terminator (ST) sequence (ESC \). These se- 
quences are explained in detail on pages 73-76. The first characters af- 
ter ESC P select the graphic protocol that is used during the rest of the 
string. These characters are formatted as part of a private ANSI control 
sequence. Table 5-1 lists the possible graphic protocols with typical de- 
vice control strings. Refer to the Received Character Processing (Chapter 
4) for complete details. 

The LA34-VA Hardcopy Descriptor protocol is explained on page 76. The 
VT105 Emulation Protocol is explained in VT105 Emulation (Chapter 6). 
The ReGIS protocol is explained here. 

ReGIS Single Character Commands 

Any commands from the complete ReGIS instruction set can follow the in- 
itial selection characters. A ReGIS command is a single alphabetic com- 
mand key character followed by options and arguments in many formats 
including parentheses and brackets. An alphabetic character can be ei- 
ther upper- or lowercase, except in any quoted string. The key character 
is usually the first letter of the name of the command, for example "S" for 
screen. Any keyletter not included in this document, and characters in pa- 
rentheses, quotes, or brackets, or any digit strings, that follow the invalid 
keyletter or a semicolon, are ignored. 

Parentheses, Brackets, Pixel Vectors, and Quotes 

Parentheses "(" and ")" after a single character mean that the charac- 
ters inside the parentheses are options to the command (example: S(E) 
= screen erase). This document shows a general option with the symbol 
command(option<arg>) where command is the command keyletter, op- 
tion is typically an option keyletter, and <arg> is the number, letter-num- 
ber, bracketed, or quoted argument of the option. The angie bracket char- 
acters "<" and ">" are shown to highlight the argument; they are never 
actually part of a command. Options have the same format as a complete 
ReGIS command. 
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Table 5-1 VT1 25 Graphics Protocols 

Protocol Example String 

ReGIS ESC P p ...data.. ESC\ 

LA34-VA Hardcopy Descriptor ESC P q ...data.. ESC\ 

VT105 Emulation ESC P t ...data.. ESC\ 



Numbers in brackets "[" and "]" are position information (also called 
coordinate or point specifiers). This document shows a general position 
with the symbol [<position>], where <position> = "x" or ",y" or 
"x,y". The first number is the x-axis or horizontal position, and the second 
number is the y-axis or vertical position. A comma separates the two num- 
bers. When, only one number is in brackets without a comma (or with a 
comma after it), it is a new x position while the y position stays the same. 

vviioii uiny wiie nuiiiuo io hi uiav/ncio wiiu a ^wiiiuia 111 nuin \ji ii, u 10 a new 
w r>oei+ir>n \A/hilo tha v nrvoifinn e+o\/e thp eomo Whan tho nnmhorc Hrv not 

have + or — signs with them, the position given is absolute (referred to 
the origin). When the numbers do have + or — signs with them, the posi- 
tion is relative (referred to the current position). At power up, the position 
coordinates have [0,0] at the top left corner of the screen and [767,479] 
at the bottom right corner of the screen. Refer to Screen Display Address- 
ing Definition, S(A), on page 143 to change the coordinate system. 

Examples: 

[200,100] is absolute, x = 200, y = 100. 

[ + 200,-100] is relative, x = current + 200, y = current — 100. 

[200] is absolute, x = 200, y = unchanged (same as [200, + 0]). 

[ + 200] is relative, x = current + 200, y = unchanged. 

[,100] is absolute, x = unchanged, y = 100 (same as [ + 0,100]). 

[,— 100] is relative, x = unchanged, y = current — 100. 

If a keyletter has one or more numbers after it with no parentheses, 
brackets, or quotes, the numbers are pixel vectors. These are position in- 
formation that specifies movement in one of eight possible directions. 
This document shows general pixel vectors by the symbol <pv> or 
<pixel vector> after a keyletter. Refer to Position Command on page 
101 for more information. 

Quotes indicate characters that the text command can put on the screen 
as they appear. Both ' and " " are quote characters. This document 
shows a general text string with the symbols 'text' or "text". Text Com- 
mand on page 1 17 explains quotes in detail. 
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Commas and Spaces 

v^piion KsyiSiiGrs sriu arcjuiTiGruS in paPGnmeses can appear next io eacri 
other (except for E) or they can be separated with commas, spaces, or 
other control characters. Separated options are easier to read and are 
good ReGIS practice except when the communication line speed limits 
performance. (Refer to Screen Erase on page 145 for E's special restric- 
tion.) 

Control Characters 

ReGIS ignores control characters (columns and 1 of Table 4-1 plus 
space and delete). The VT125 (which supervises the communications be- 
tween ReGIS and the communication lines), monitors the data for ESC. If 
ESC appears, the VT125 checks for the string terminator sequence. If the 
sequence is the string terminator (ESC \), the VT125 returns to text 
mode. If the sequence is a control function that applies to the graphics 
processor (DA, DECID, DECTST, DSR, MC, RIS, refer to Chapter 4), its ac- 
tion is performed. Any other characters after ESC pass to ReGIS as 
ReGIS commands, not as ANSI control functions. 

Because ReGIS ignores control characters, ReGIS command strings can 
be formatted to make them easy to read. In particular, spaces, carriage 
returns, and linefeeds can be in the listing of ReGIS commands as instruc- 
tions to the terminal or printer for page formatting for display. Most of the 
commands in this book are shown with spaces between keyletters and ar- 
guments for clarity. The commands can be copied exactly because ReGIS 
ignores the spaces, but to save storage and communication time, all 
spaces can be removed except those inside quoted strings. 

Order of Performance 

Each command is acted on as it arrives. ReGIS always responds to each 
command and option as soon as it has enough information to work with. A 
command keyletter can be followed by: 

• Digits, 

• Pairs of parentheses, 

• Pairs of brackets, 

• Pairs of quotes, 

• Any combination of the above with option keyletters and arguments, 

• Or another command keyletter. 

The last command keyletter to arrive defines the meanings of the follow- 
ing options and arguments. It can only act as a command keyletter (in- 
stead of an option keyletter) if it follows matched sets of parenthesis, 
brackets, and quotes. 

The parentheses, brackets, and quotes described above control the way 
ReGIS responds to the characters of the string. For example, a left 
bracket "[" tells ReGIS to look for a position specification. A right bracket 
"]" ends the position specification. If a communication line error or a pro- 
gramming error loses the right bracket, all the following ReGIS commands 
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will probably be understood incorrectly. The semicolon character (if in- 
cluded in the string of commands) clears any control errors caused by un- 
matched sets of parentheses or brackets. This is called synchronization. 
Enough semicolons mixed with commands can help get the most usable 
image on the screen even in the presence of communication problems. (A 
semicolon cannot clear errors involving quotes because inside quotes, it 
is a literal character instead of an instruction.) 

An option selection applies to all the following related commands unless it 
is a temporary write option or a curve option. For example, the W(C) com- 
mand causes all writing to be in complement mode until another writing 
mode command is given. However, a writing control can be a temporary 
option if it is an option to any P, V, C, T, or S command. For example, a 
pixel vector multiplier that is set by a writing control command as an op- 
tion in a Screen Scroll command applies only to that command, for ex- 
ample S(W(M100))<pv>. Options can be specified by their option key- 
letter in parentheses without repeating the command keyletter if no other 
command keyletter has been used. For example, a line can be drawn with 
the vector command starting with one temporary writing control intensity 
setting and ending with another: V (W(I3)) [+100] (W(!2)) [+100]. 

Numeric Values 

The VT125 does all its calculations with integers. This means that the 
smallest meaningful value that it can understand is the distance between 
two pixeis. That distance is 1. The terminal's coordinate system is de- 
signed to address the pixels with integers. The VT125 accepts decimal 
fractions (1.53) and floating point numbers (3.215E2) so that images can 
be transported to higher resolution ReGIS devices. However, those num- 
bers are truncated (cut off) during processing so that only the integer por- 
tions are used in calculations, with no rounding (1.53 = 1, 3.215E2 = 
321). Floating point numbers are truncated to 16-bit signed integers (after 
scaling, if allowed by the coordinate system); values larger than 
(2* * 15)- 1 are kept as (2**15)— 1, and values smaller than -(2**15) 
are kept as -(2**15). 
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POSITION 

The most basic concept in the use of ReGIS is current position. This is a 
location on the screen with many possible functions. It is generally the 
last position where a drawing or command action occurred. It may be the 
location of the next pixel to be drawn, the center of a circle, the starting 
point of a vector, or many other things. If ReGIS is active in the VT125 but 
not processing data, a blinking graphic cursor appears to mark the cur- 
rent position. The graphic cursor is a diamond shape with a cross in it. 

Coordinates 

A coordinate is a number that specifies a position. X-coordinates specify 
horizontal positions and Y-coordinates specify vertical positions. A point 
is the intersection of an imaginary vertical line that passes through an X- 
coordinate and an imaginary horizontal line that passes through a Y- 
coordinate. So a pair of coordinates specifies a point. (The coordinates 
are sometimes called point specifiers in ReGIS documentation.) The gen- 
eral symbol for a pair of position coordinates in this book is [<position>]. 

When the VT125 is first powered up, it starts counting screen positions at 
the top left corner of the screen. This position is called the screen origin 
and has coordinates [0,0]. The X-coordinates start at at the left margin 
of the screen and end at 767 at the right margin. The Y-coordinates start 
at at the top margin and end at 479 at the bottom margin. With these 
coordinates, the VT125 can address all pixels on the screen with integer 
numbers. On the 12-inch monitor screen in the VT125, horizontal pixels 
are about one-hundredth of an inch apart. The scan lines, which define the 
vertical pixel spacing, are about two-hundredths of an inch apart. To let 
the same number of horizontal and vertical addresses be equal distances 
on the screen, the addressing counts by one for horizontal pixels and by 
two for vertical pixels. Refer to explanation of pixels in Writing Commands 
on page 105. 
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POSITION COMMAND 

The P (position) command sets or changes the current position and 
moves the graphics cursor to the new current position. 



Absolute Position 

P[<x-coordinate,y-coordinate>] 

This command moves the current position to the given coordinates re- 
ferred to the origin. If a coordinate is not signed, it is an absolute coordi- 
nate. If an x- or y- coordinate is not given, its value is unchanged. 

Relative Position 

P[< ± x-change, ± y-change>] 

This command moves the current position by adding the given numbers to 
the last current position. If a coordinate is signed, it is a relative coordi- 
nate. If an x- or y- coordinate is not given, its value is unchanged. (For 
negative values of change, adding is the same as subtracting a positive 
value.) 

Combining Absolute and Relative Positions 

Absolute and relative values can be combined in one command. Sign the 
coordinate that is relative and leave the absolute coordinate unsigned. 

Null Position 

P[] 

This command resets the writing pattern so that the next writing operation 
begins with the first bit in the pattern memory. Refer to Patterns in Writing 
Controls on page 136. The "[]" argument is a relative position specifica- 
tion indicating no change in x or y. 
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Pixel Vectors 

P<pixel vector> 

This command moves the current position in the direction specified by 
<pixel vector> (also shown as <pv>). A pixel vector is a vector whose 
length is the distance between two adjacent pixels times a multiplier that 
is set with a writing control command. A pixel vector has a limited set of 
directions that it can specify. These are eight directions at 45 degree in- 
tervals starting at on a 360 circle. They are specified by the integers 
through 7 according to Figure 5-1. 

Each time a pixel vector number appears after the keyletter P, the current 
position moves one pixel multiplier in that direction. Thus, with the default 
multiplier, P000 moves the current position three pixels to the right. Refer 
to Temporary Pixel Vector Multiplier. 

Temporary Pixel Vector Multiplier 

P(W(M<multiplier>))<pv> 

This command sets a temporary pixel vector multiplier for the following 
series of pixel vectors in this command only. The multiplier can be any 
positive integer. Each pixel vector number that follows the multiplier 
moves the current position by the multiplier number of pixels. When the 
VT125 powers up, the multiplier is 1, meaning that each command moves 
the current position only one pixel (a very small amount). The multiplier 
increases the power of the pixel vector command. Refer to Pixel Vector 
Length Multiplier on page 133 for the genera! command. 




Figure 5-1 Pixel Vector 
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Begin a Bounded Sequence of Coordinates 

P(B) 

This command saves the first position to allow return to the beginning po- 
sition without respecifying that position. The saved position is restored by 
the (E) option. The (B) option can be repeated up to 10 times and each 
value of position is saved. Each (E) option then restores the most recently 
saved position, until the tenth (E) option restores the first value saved. 
The positions stored and recalled include those stored in the vector V(B) 
command. 

Start an Unbounded Sequence of Coordinates 
P(S) 

This command is similar to the (B) option explained above except that it 
specificaiiy does not move the cursor at the end of a sequence of posi- 
tions. (S) saves a dummy or nonacting position in memory so that the 
next (E) option does not change the current position. Positions saved by 
(S) are in the same memory as (B) positions and are included in the ten 
count. The position (S) option is provided for symmetry with the other 
commands that have (B) and (S) options. 

End a Sequence of Coordinates 
P(E) 

This command restores the first position at the end of a P(B) command. 



B, S, and E options are used to group sets of coordinates together in 
blocks (position blocks) so they can be processed as units, for example, 
for polygon definition or filling or shading operations. The position blocks 
do not have to be completed in a single P command, and they can have V 
or C commands inside them. Refer to B, S, and E in Vectors on page 107 
and Curves on page 1 13. 

Table 5-2 is a summary of the position commands. 
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nHHHHHBHHIII 

[<position>] 

< pixel vector> or <pv> 

(W(<temporary writing controls>)) 



Reset pattern memory 
Move to <position> 



} Move <multiplier> pixels 
} in <pv> direction 



} Save current location 

llillilllilllSlllllilllSilllSiSISS 

} Save dummy location 

J Move to last saved location 

1 P(W(M< multiplier^) 
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WRITING COMMANDS 

This section explains how to specify locations of pixels for lines, shapes, 
and text. The next section, Writing Controls, explains the attributes of in- 
tensity and pattern that pixels and shapes can have. The Screen Controls 
section explains the controls for the color and background of images, the 
positioning of the complete image, timing of actions, and the production 
of hardcopy output. 

Pixels 

A pixel is the smallest unit of color and intensity information on the 
screen. The intersection of every horizontal address and every even verti- 
cal address is a pixel. (Refer to Coordinates on page 100.) The writing 
commands do two processes at each address. They access the address 
(prepare to write into it) and then act on it. The action can be setting bits 
(refer to Foreground Planes in Screen Controls on page 140) clearing 

+ l"»OT» onmnlomontinn thorn r\r norhpnc rlnipri neitkiinn at all fQofor tr» Pat. 

terns on page 136.) 

Odd-Y Simulation 

There are 512 defined vertical addresses but only 256 actual memory lo- 
cations. Only even-numbered vertical addresses have any associated 
memory. The next higher odd vertical address accesses the same pixel 
memory as the even address. This is called odd-y simulation and allows 
dimensions to be consistent in both axes (squares have the same number 
of addresses on each side). Some combinations of pattern and multiplier 
may give unexpected results because of odd-y simulation. Refer to Pat- 
tern Multiplier on page 138 for more information. 
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VECTOR COMMAND 



i ma uuiiinicii iu uitiws a siictiyiu nut; utJiween ine uurreni uursur lucauun 
and a specified screen location. 



Dot at Current Position 

V[] 

This command draws a dot (one pixel) at the current position. It is useful 
because most other vector commands do not draw the pixel at the current 
position. 

Vector from Current Position to Specified Position 

V[<position>] [<position>] ... 

This command draws a straight line from the first pixel after the current 
position to the position given. Any number of positions can be included in 
the same vector command to draw a continuous series of straight lines. 
The first dot of each line is not drawn so that the next line can connect 
smoothly to the previous line. Use the dot command V[] to draw the first 
dot of a series of vectors. 

NOTE: With shading on, the vector command draws from the current po- 
sition. 

Round-off errors in the VT125's computation of vectors can add. The main 
causes of cumulative errors are relative coordinates or nondefault display 
addressing (refer to Screen Display Addressing Definition on page 143) 
especially with noninteger specifiers. If you need an absolute position af- 
ter a series of vectors, include a Position command. This starts the next 
commands at a known location. 

Refer to Patterns on page 136 for details about how the vector command 
uses patterns. 
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Figure 5-2 Pixel Vector 

Pixel Vectors 

V<pixel vector> 



This command draws a line one pixel multiplier long in the direction speci- 
fied by <pixel vector> (also shown as <pv>). The direction may be any 
of the integers through 7 according to Figure 5-2. The direction numbers 
represent angles at 45 degree intervals from (0) to 315 (7). 

Each time a pixel vector number appears after the keyletter, the line is 
drawn one more pixel multiplier in that direction. Any number of the eight 
pixel vectors numbers can appear in the command. Thus, V00066 draws a 
line three pixel multipliers to the right and then two pixel multipliers down. 
(The pixel multiplier is the actual number of pixels changed in any com- 
mand that affects pixels. The power-up default is 1 but it can be set to any 
convenient value. Refer to Pixel Vector Length Multiplier on page 133. 



Bounded Sequence of Positions 

V(B) [<position>]...[<position>] (E) 

The (B) option saves the current position in the graphics processor's 
memory. This helps you draw a sequence of vectors that ends at the 
starting position. At the end of the sequence, the (E) option recalls the 
starting position. The vector command then draws a line from the last 
specified position to the saved position. The (B) option can save up to 10 
positions in memory. Each (E) option recalls the position saved by the last 
(B) option and erases the position from memory. The positions stored and 
recalled include those stored with the position P(B) command. Figure 5-3 
illustrates the action of the "nested" (B) and (E) options. (E) 2 recalls (B) 
2; the next (E) is 1 which recalls (B) 1. 

V (B) [<position1>] (B) [<position2>] -^ (E) [<position2>] (E) 
[<position1>] 
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1+00,3001 



p(200,1001 v(b)[200, 2001(b) v[300,4001 
v[400,3001 v(e)cl+51 vC100,501 v(e)ct+101 



Figure 5-3 Nested (B) and (E) Commands 

Unbounded Sequence of Positions 

V(S) [<position>]...[<position>] (E) 

The (S) option is similar to the (B) option explained above except that it 
specifically does not move the cursor or draw a vector at the end of a 
sequence of positions. (S) saves a dummy or nonacting position in memo- 
ry so that the next (E) option does not change the current position. Pos- 
itions saved by (S) are in the same memory as (B) positions and are in- 
cluded in the ten count. 

The vector (S) option is provided for symmetry with the open curve (S) 
option. (Note that the open curve option requires null position specifiers 
to draw the same segments as the Vector (S) option. These specifiers in 
a sequence of positions do not affect the vector command except for 
drawing the first dot of a line.) 

Temporary Writing Controls 

V(W(<temporary writing control options>)) 

The temporary writing control options are the same as the writing controls 
command options but they apply only during the vector command that 
they are in. Only options specified or implied by those specified are 
changed. Options return to their previous values at the end of the V com- 
mand. 

Table 5-3 is a summary of the Vector Commands. 
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Table 5-3 Vector Command Summary 

[<position>] 

< pixel vector> or <pv> 

(W(<temporary writing controls>)) 



Draw dot at current position 

Draw vector to <position> 

Draw <multiplier> pixels 
in <pv> direction 

Save current position 

Save dummy position 

Draw to last saved position 

V(W(M< multiplier^) 
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CURVES 

called curves. 

• Circles 

• Arcs 

• Closed Curves 

• Open Curves 

A circle is a group of pixels that are all the same distance away from a 
center position. There are two types of curve commands that generate 
circles; they use different information to specify the circle. 

An arc is a part of a circle. There are two types of curve commands that 
generate arcs; they use the same information as the two circle commands 
to specify the circle of which the arc is part. They also use information to 
determine what part of the circle is drawn. 

A closed curve is a general curve that is made by interpolating the loca- 
tions of pixels around four or more specified locations. The closed curve 
is a bounded shape like the circle (which is a special case of the closed 
curve) or an ellipse. 

An open curve is a general curve that is made by interpolating the loca- 
tions of pixels around several specified locations. The endpoints of the 
open curve are not meant to meet. Pay special attention to the endpoints 
of an open curve to get the wanted graphic object. 
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Circles 

Circle with Center at Current Position 

C[<position>] 

This command draws a circle around the current position with the circum- 
ference at the specified position (Figure 5-4). The radius of the circle is 
the distance from the current position at the center to the circumference. 

The current position stays at the center after the circle is drawn. 



/ CURRENT POSITION 
/ (START & END POSITION) 




[+1W,+501 



pl384,24G] c[+i&e,+5Gl 

MA-9441 



Figure 5-4 Circle with Center at Current Position 

Circle with Center at Specified Position 

C(C)[<position>] 

This command draws a circle around the specified position with the cur- 
rent position located on the circumference. (Figure 5-5). The radius of the 
circle is the distance from the current position to the center. 

The current position stays at the starting location on the circumference 
after the circle is drawn. 
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[284,3d0] 
CURRENT POSITION 
(START & END POSITION) 

pI284,3eei C<C)I + iW,-iWl MA-9439 

Figure 5-5 Circle with Center at Specified Position 

Arcs 

An arc is a part of a circle. It is specified by the location of the center of 
the circle, radius of the circle, starting position of the arc, and amount of 
the circle to be drawn, measured in degrees. A complete circle is 360 de- 
grees. The VT125 draws a circle as 36 vectors, each covering 10 de- 
grees. Degree specifiers are rounded down from 4 and up from 5 to the 
nearest 10 degree increment. The minimum specifier is 5, and specifiers 
greater than 360 are interpreted as 360. 

Arc with Center at Current Position 

C(A<degrees>) [<position>] 

This command draws an arc that is <degrees> around a circle starting 
from <position>. The radius of the circle that the arc is a part of is the 
length between the current position and <position>. The graphics pro- 
cessor draws the arc counterclockwise for the specified number of posi- 
tive degrees and clockwise for negative degrees. The current position 
stays at the center after the arc is drawn (Figure 5-6). 



■^140 degrees ">>I+iee, -i«01 



(1489,1353) 



CURRENT 
POSITION 

c [384, 240] 
f , i5 oci! V (START & END 
1242,2631 POSITION) 



pl384,2401 c^al4*>[+m-lWl 

MA-9440 

Figure 5-6 Arc with Center at Current Position 
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Arc with Center at Specified Position 

C(A<degrees> C) [<position>] 

This command draws an arc that is <degrees> around a circle starting 
at the current position. The center of the circle that the arc is a part of is 
at <position>. The radius is the distance between the current position 
and <position>. The graphics processor draws the arc counter- 
clockwise for the specified number of positive degrees and clockwise for 
negative degrees. The current location is at the end of the arc after the 
arc is drawn. (Figure 5-7). 



t-iW,-100] 



(NEW CURRENT NN„. .93 ...-^(CURRENT POSITION) 
POSITION) "" "' ' 



c(a-9Gc>l-lW,-lWl 
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OPEN AND CLOSED CURVES 

Interpolation of Curves 

Given a sequence of positions, ReGIS can draw a curve between the posi- 
tions. The curve represents a generalized nonlinear function that inter- 
sects all the specified positions. It is generalized because it is not the re- 
sult of the actual function that specified the points. It is the result of a 
graphic technique that produces a reasonable imitation of a function 
curve. The curve indicates the presence of a nonlinear function, rather 
than the function itself. You cannot get accurate intermediate values from 
a graphics processor curve unless you have given enough positions to 
make sure that the curve generator is closely following your function. The 
curve generator can produce a curve segment with as few as four posi- 
tions. The result can be misleading if the positions are too far apart to 
define the function by themselves. 
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Unbounded (Open) Curves 

P[<position>]C(S)[][<position>]...[<position>][](E) 

An open curve is a general curve that is made by interpolating the loca- 
tions of pixels around several specified locations. The endpoints of the 
open curve are not meant to meet (Figure 5-8). Pay special attention to 
the endpoints of an open curve to get the graphic object that you want. 
The open curve option can draw a curve segment with as few as four posi- 
tions including the position preceeding the (S) option. To make sure that 
segments are drawn between all given positions, include null position 
specifiers ([]) at the beginning and end of the list of positions. Otherwise, 
only the segments from the second to the next-to-last positions are 
drawn. 

The current position stays at the next to last position specifier after the 
curve is drawn. When null specifiers are used, the last position and the 
next-to-last position are the same. 



[100,200] 

START POSITION 




END POSITION 
[120, 390 J 



[420, 360] 



,p[100,200] c(s)[] [370,501 [420,3601, [120,390] [1(e) 



Figure 5-8 Unbounded (Open) Curve 
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Bounded (Closed) Curves 

P[<position>]C(B)[<position>]...[<position>](E) 

A closed curve is a general curve that is made by interpolating the loca- 
tions of pixels around four or more specified locations. The closed curve 
is a bounded shape like the circle (which is a special case of the closed 
curve) or an ellipse (Figure 5-9). The (B) option saves the beginning posi- 
tion and the (E) option closes the curve by providing the beginning posi- 
tion as the last position specifier for the curve command. 

The current position returns to the second position specifier after the 
curve is drawn. 



END POSITION 

use, 1231 

ffi 




[573, 1631 



[233, 2431 < 

START V ^ [483,2431 

POSITION 

[320,2831 



pl233,2431 c(b) [323, 1631 [483,1231 
[573,1631 [483,2431 [323,2831 (e) 



Figure 5-9 Bounded (Closed) Curve 
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Temporary Curve Writing Controls 

C(W(temporary writing controls)) 

The temporary writing control options are the same as the writing controls 
command options but they apply only during the curve command that they 
are in. Only options specified or implied by those specified are changed. 
Options return to their previous values at the end of the C command. 

Table 5-4 is a summary of the Curve Commands. 



Table 5-4 Curve Command Summary 

C ! [<position>] 

{ (C) [<position>] 



{ 



■lA<degr^s>);|<^^cai>j 



(A<degrees>G]l<pbsitibn>]: 



(B) [position] . Z ■ {position} ©v 
(S) [] [position];;. ;; ;. [position] [ ] (E) 

(W(<temporary writing controls>)) 



I Circle with center at current 
! position, circumference at 
j< position> 

! Circle with center at 

! <position>, circumference 

} : ■at€tirrettt:0b^iti<)n 

'}: Arc with reenter at current 
j^poslion^artihgr'ai ■;;:;;;; ^-y:;^ 
] ■"< p6sitiori>f or'. ; .<» : .degr.ees : > : i ; - ■ '■:■< 

} Arc with center at <position>, 
j starting at current position 



Bounded (closed) curve 
Unbounded (open) curve 



i 
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TEXT 

The graphics processor displays characters differently from the text ter- 
minal. The ReGIS text command can draw characters with many com- 
binations of size, orientation, and position. 

The text command is formatted as a keyletter followed by options and a 
quoted string. All options in the T command (except temporary write op- 
tions) apply to all following T commands until they are changed in another 
T command. ReGIS understands that two quotes of the same kind next to 
each other, inside a string that is delimited by the same kind of quote, 
means that one quote is supposed to be displayed inside the string. But 
with both kinds of quotes available, you can include one kind or the other 
inside the string without having to double it up. Two strings delimited by 
the same kind of quotes can be concatenated by separating them with a 
comma. For example, "stop*", "here" and "stop*here" are the same. 
Empty strings are allowed (""), because doubling only occurs inside a 
string. There is no defined upper limit on the length of a string. 

ReGiS never uses the characters inside a pair of quotes or doubie quotes 
as commands. These include the semicolon synchronization character 
and the macrograph definition and invocation characters. Printing charac- 
ters (space through ~, octal 40 through 127, refer to Character Sets in 
Chapter 4) are displayed according to the pattern stored in the currently- 
selected alphabet. (This defaults to ASCII.) All control characters except 
CR, LF, HT, and BS are ignored. 
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CR (carriage return) moves the active position to the position it had when 
xhe current quoted string began to be drawn. LF (iinefeed) moves the ac- 
tive position down a distance equal to the current vertical cell size. HT 
(horizontal tab) acts as a nonprinting space. HT moves the active position 
forward one character position without affecting any image in that charac- 
ter position. BS (backspace) moves the active position back one current 
text spacing distance to the last written character position. This is the 
simplest method of performing an overstrike (drawing two characters in 
the same place, such as zero with a slash). 

The initial position in a text command is the current position at the end of 
any other writing command. This position is the top left corner of the next 
character to be drawn. The size and spacing values of the text command 
then control where the next current position occurs. 



TEXT COMMANDS 

Initial Text Defaults 

When the VT125 graphics processor first powers up, many of the text 
commands listed in this section have default values assigned. The 
defaults allow the graphics processor to respond immediately to many of 
a novice ReGIS user's commands. General applications should include 
text command specifications at the beginning of each graphic image to 
ensure the needed state of the graphics processor at the time of image 
generation. The defaults are: T[ + 9, + 0] (S1, H2, S[9,20], M[1,2], DO, 10). 



Text 

T 'ABCD' 

This is the basic form of the text command. It can be used when the op- 
tions' settings are known to be correct. 

Text Character Cell Size 

T(S<size number>) ' ABCD ' 

This command selects a character cell size from a standard set of sizes. 
The sizes are multiples of a predetermined width of 9 and height of 15. 
The sizes are numbers in the range of to 16. The resulting character 
cells are the size number times 9 pixels wide and the size number times 
15 pixels high, except for size characters (which are 5X10 pixels in 
size), and size 1 characters (which are 9 X 20 pixels in size). The size 1 
characters are close in size and vertical spacing to the VT100 charac- 
ters. 
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The rest of this section refers to the region defined by a bit in the charac- 
ter cell memory as a unit instead of pixel. The word "unit" is used be- 
cause the commands in this section can display text that has more than 
one pixel controlled by each bit. 

A standard character cell is 9 units wide by 15 units high. The character 
that is displayed in the cell is 8 units wide and 10 units high. (80 bits are 
stored for each character in the graphics processor's character memory.) 
This standard combination of cell and character sizes results in one hori- 
zontal unit and five vertical units of spacing between characters. 

Because of the default character cell size that is selected with this com- 
mand, there is room for 9 horizontal units of pattern in the default cell but 
there are only 8 units of information available. To fill the ninth space, the 
graphics processor copies the unit from the first position of the character 

»->£>++/->•-•-» ^Ciniiro K_ir^ KAnet nhprpptore nf ^horprtor cat C\ f+ho normanont 
uduciii \i lyuic v-> iu/. mv/oi uiiqiuuiuiO vi vhuiQuiui \->v^i \s \ul\/ ^uuiiaiiuiii 

set) are only seven units wide and are right justified in their pattern cells. 
Therefore, the first unit of each scan of the character is dark. When this 

irSl urill ytJlii UUpieu IU me iimlTi pusmun m uio oon, mfc iiiiilii pCJoiuOii ib 

also dark. The result is characters that are seven units wide and spaced 
two units apart. 

Because the first unit of a cell is copied into the ninth position, continuous 
patterns (like the underline of character set 0) can be drawn. If the first 
unit of a character is visible but you do not want that unit repeated, use 
the explicit character specifiers (shown in following command descrip- 
tions) to obtain a character cell that is eight units wide instead of the 
default nine units of this command. 

All of the values that are set by default in this command can also be set or 
modified by using the following group of explicit character specifiers to- 
gether. This group of specifiers also illustrates the parameters that are 
set by the S command. The pairs of commands shown in Table 5-5 are 
equivalent and provide character cells that are nine units wide. 



} 



• oooooooi 

123456789 



Figure 5-10 Copying Unit 1 to Unit 9 
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Character Character 


Pixel 




Spacing Cell Size 


Multiplier 


:T(S1) =! 


T[+9,+0] (S[9,20] 


M[1.2]) 


T(S4) = 


T[+36,+0] (S[36,60J 


M[4,6]} 


T(S16) = 


T[+144,+0] <S{ 144,240] 


M[16,24]) 



Text Character Height Multiplier 

T(H <multiplier>) 

This command selects a nonstandard character aspect ratio when using 
the text character size command. <multiplier> is an integer from 1 to 25 
which multiplies the 10-pixel height of the character pattern after the 
character size command sets the standard width. The largest multiplier 
causes a character which is within 5 pixels of the largest character cell 
size possible (255). (Larger values cause distorted and incomplete char- 
acters.) 

Text Character Spacing 

T[<position>] (<options>) 

The spacing option follows the T command keyletter before any options in 
parenthesis. It is a relative position specifier that indicates the distance 
and direction that the active position must move from the top left corner of 
one character to the top left corner of the next character (Figure 5-11). 
Use this command with the text character cell size and text pixel multi- 
plier options. The default spacing used with the S<integer> option is 
[ + 9. + 0] which leaves one pixel between characters and keeps all char- 
acters on the same horizontal line. 



ABCD a 

B C D D 

+* T[-32,+44]'ABCD' 

T [+32, +281 'ABCD' 

Figure 5- 1 1 Text Character Spacing 
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The spacing option values are always relative and the option sets both x 
and y every time it is used, even if a value is omitted. Therefore, an 
omitted value causes that dimension of spacing to be set to relative 0, 
which means it will draw the next character at the same x or y position. 
For horizontally arranged text, the y value can be or omitted. If the x 
value is also or omitted, the following characters are all drawn in the 
same location (overstriking). 

NOTE: For occasional overstrikes, use the backspace control character 
in the text string. 



Text Pixel Vector Spacing 
T <pv> 

This command is not in parentheses and uses pixel vector numbers to in- 

_i: j. _ _i: x:_ ~x A x< n »4. f~- .-.u „..,,,■* 4. „ -,-, TU« ^,^,^..^4- ^x ^*x,_^+ ;„ ^J^4-^» 

Uiucue uiieouuiia ui uncsei iui onaiaoicia. i iic aniuuiu ui unoci 10 ucicr 

r-r-. i r-. Q /-I \rw i the oi-rQ r\t \\n e\ ^horantare ar\r\ io nna-half r\f tho ni\/pr> r^harap- 

IIMIIOli Uy II IO OI£.C KJl lll^ VIIUIUUlV^lO, t*l IV) IO UIIU null VI 111^ ^ivOii v/iiuiutj 

ter's size in the direction of movement. The pixel vector multiplier does 
not apply. The vector direction is relative to the character baseline so this 
command is affected by the tilt direction option. 

From the pixel vector directions given in Figure 5-12, T6 makes the follow- 
ing characters appear as subscripts (moved down from the current base- 
line by one-half character height). T2 produces superscripts, and T44 
moves a character back one complete character width to produce an 
overstrike. Offsets up and down from the character baseline must be fol- 
lowed by reversing offsets to put the rest of the characters back on the 
baseline. 




Figure 5- 1 2 Pixel Vectors 
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Text Character Cell Size 

T(S[<width in pixels>,<height in pixels>]) 

This command sets the size of the area on the screen that is drawn by a 
single character T command. The maximum area specifier is [255,255]. 
(Larger specifiers are counted modulo 256.) Use this command with the 
character spacing and text pixel multiplier option to select nonstandard 
character sizes and aspect ratios. A cell with room for 8 horizontal units 
and 15 vertical units is some multiple of [8,15]. (Compare to sample S op- 
tion in character cell size.) 

Refer to Figure 5-13. If the cell is smaller than the character that appears 
in it, the character is cut off at the right and bottom edges. If the cell is 
larger than the character that appears in it, the character repeats as 
many times as possible across the width of the cell, and the next alphabe- 
tical characters in the character set appear sequentially and repeatedly 
along the remaining height and width of the cell. 

Text Pixel Multiplier 

T(M[<width mult>,<height mult>]) 

This command specifies how many pixels in the display will be controlled 
by each pixel in the character pattern. The command multiplies the pixels 
of each character by the given width and height multipliers. The maximum 
multiplier is [16,127]. (Larger specifiers set the multipliers to the max- 
imum values.) Use this command with the Character Spacing and Charac- 
ter Cell Size options. 

If a character cell has been selected that is 18 X 30 pixels in size, for 
example, pixel multipliers of [2,3] must be selected to adjust the charac- 
ter to fill the cell. This example is a standard size. Many other com- 
binations are possible. Refer to Figure 5-13 for more examples. 



an 



T[+36,+ei<S[32,60],Ml7,10])'ABCD' 

AftttBBBBCCCCDDDD 
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ABCD 

Tl+36 / +ei(St32 / 601,M[4,61)'ABCD' ma 9443 

Figure 5-13 Text Character Ceii Size 
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Text String and Character Tilt Direction 

T(D<direction angle> S<size number>) 

The direction command has different effects depending on how it is for- 
matted. The simplest form of the command is given above; this controls 
the tilt of the baseline for a text string. A text string can be tilted at any 45 
degree interval (either positive or negative), on a 360 degree compass 
(Figure 5-14). Compass values other than 45 degree intervals are trans- 
lated as the nearest lower 45 degree increment. The size option can be a 
repeat of the last chosen value or a new value but must be included. Char- 
acters reading from left to right are not tilted if the baseline is at de- 
grees, and they are upside down if the baseline is at 180 degrees (refer to 
the left example in Figure 5-15). Both the baseline and the characters are 
tilted. You may need to adjust the size for tilted characters because the 
VT125 does not control the scaling between horizontal or vertical and di- 
agonal characters. 

The next form of the command controls both the text string baseiine tilt, 
and the tilt of individual characters in the string. 
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Figure 5-14 360 Degree Compass 
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Figure 5- 1 5 Text String and Character Tilt Direction 
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T(D<string tilt> S<size number> D<character tilt>) 

The first D value sets the tilt for the complete text string, and the second 
D value sets the tilt for each character in the string. Refer to the middle 
and right examples of Figure 5-15. The baselines are tilted but the charac- 
ters are not. 

The D option works by setting the tilt of characters. Then the character 
size <size number> option uses the angle specified by D to calculate 
the spacing needed to position the tilted characters on a common base- 
line. After spacing information is calculated by the S<size number> op- 
tion, another D option changes the character tilt again to the final value 
before drawing starts. 

Some display combinations can also be produced with other options. For 
example, many values of string direction other than 45 degree intervals 
can be drawn with the explicit spacing option. And if the string tilt is 0, the 
italic option gives better results and more values of character tilt without 
requiring a spacing option. 



Text Italic Tilt 

T(l<ltalic degrees>) 

This command tilts the vertical lines of individual characters without tilting 
the horizontal lines. (Refer to Figure 5-16.) Table 5-6 lists the values of tilt 
that are available in the VT125 and the specifiers needed to get them. 
Positive specifiers tilt the characters to the left according to the compass 
directions in Figure 5-14. Note that the actual angles of tilt are approx- 
imate, and smaller tilt angles may distort small characters. Specifiers be- 
tween the listed values set the tilt to the next lower value. This command 
can be used with the D option. 



H sY W 

p[2e,10$l t(s8,i0) p[35e,iWJ 1(58,1-45) pt5W,lWl t(s8,i22> 

MA-9445 

Figure 5-16 Text italic Tilt 
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Table 5-6 Italic Tilt Values 



Italic 


Approximate 


Specifier 


Angle 


± 


WlKISKtSSS 


ISilllfSS 


lililiKllili 


± 2 


IJIIiBliSiHIISB 


± 3 


llSStliiSISSI. 


± 4 


IlillSlSlSSSiiii 


± 5 


llSliSilfll 


± 6 


liSUBSiSilSli 


WiiilHlSli 


±10 


± 9 


ISIiiiXilSlliiiSlt 


±11 


WKKBSftillliSiSi 


±13 


±20 


±19 


±25 


±31 


±45 



T(A <character set number>) 

This command selects the character set that is used for all text com- 
mands until another set is selected. The number can be 0, 1, 2, or 3. Set 
is the default character set which is ASCII and cannot be changed. Sets 1, 
2, and 3 are user-loadable 95-character memories. If a character cell has 
not been loaded, it is displayed as a filled in block. 

This command only selects a character set for display. Refer to Character 
Cell Controls on page 155 for the command that selects a character set 
for loading, and for the command that loads the character set. 



Store and Restore Options 



T (<current options>) ABCD' 

(B) (<temporary options>) ABCD' (E) 

All text options controlled by the T command can be saved as a unit and 
later restored to their saved settings. The (B) option saves the current 
text option values in the graphics processor's memory. You can make 
changes to one or more of the current options with another T command 
and display text with the changed options, and you can draw other graph- 
ic objects. Then, the (E) option restores the saved option values for the 
following text display. Only one set of option values can be saved at a 
time. This feature allows you to temporarily change the text display op- 
tions without needing to respecify the original values when you return to 
them. 
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Temporary Writing Controls 

T(W(temporary writing controls)) 

This command allows writing control options that only affect text drawn 
during this particular command. Usually, writing control options stay ac- 
tive for all following writing commands until they are respecified. The tem- 
porary writing controls command allows temporary changes to color 
specifiers, writing modes, etc., during the text command that they are in. 
The writing controls that are in effect for all commands except this par- 
ticular text command stay unchanged. Refer to Writing Controls on page 

127 for the formats of writing controls options. 

Table 5-7 is the Text Command summary. 

Table 5-7 Test Command Summary 

T ( (S <size number>] } 

| (H <height>] J 

{ [ <spacing >] J 

! (S [ <width in pixels>, <hetght in pixels>]) } 

{ (M [ < width pixel multiplier^ <height pixel multiplier^) } 

{ (D <direction angle>) } 

! (D <string tilt> S <size> D <char tilt>) \ 

{'(I < italic degrees>) } 



{ (A <pattern set number>) 

« 

! ((B) <temporary attributes block> (E)) 

i (W(temporary writing controls)) 
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WRITING CONTROLS 

This section describes the attributes of intensity and pattern that pixels 
and shapes can have, and explains the commands that control the attri- 
butes. 

Initial Writing Control Defaults 

When the VT125 graphics processor first powers up, many of the writing 
controls listed in this section have default values assigned. The defaults 
allow the graphics processor to respond immediately to many of a novice 
ReGIS user's commands. General applications should include writing con- 
trol specifications at the beginning of each graphic image to ensure the 
needed state of the graphics processor at the time of image generation. 
The defaults are: W(V, 13, F3, M1, NO, P1, P(M2), SO). 

Writing Modes 

The four writing modes (Complement, Erase, Replace, and Overlay) can 
be used at any time, but only one at a time. They control the way pixels 

ore r-JooaH in <a nronh!^ Imona ar»rl thtiir mainr offor^tc aro v/icihlo \A/hon a 

part of the image already exists. 



Complement Writing 
W(C) 

During a write, this command complements the bit pattern of the fore- 
ground specifiers of the pixels present in the existing image wherever the 
pattern register is 1 and does not change wherever the pattern register is 
0. (Refer to Foreground Planes on page 130, Patterns on page 136, and 
Figure 5-17.) Complement writing is generally reversible by repeating the 
same writing command. Complementing the foreground specifier gives 
the results shown in Table 5-8. 

Use the foreground planes command to get other combinations with com- 
plement writing. 
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\\\\\\W 



COMPLEMENT WRITING 



Figure 5- 1 7 Complement Writing 



Table 5-8 Complementing the Foreground 



Initial 

Foreground 

Specifier 


Specifier 

Bit 

Pattern 


Complemented 

Foreground 

Specifier 


Specifier 

Bit 

Pattern 


f-"'"-"- : jl.3.T ■:'.' : ;:".':. : . : -.'^-K : :^-:-; -\ : ' :"';!': 

: - : : ::: J2V-y ir&; : '; : ' ;:: : 
n 

10 


1 
1 







1 

1 


Erase Writing 








W(E) 









This command writes each pixel with the background specifier if negative 
writing (W(NO)) is off (Figure 5-18), or write each pixel with the foreground 
specifier if negative writing is on. This command does not use the pattern 
register. 



Replace Writing 



This command replaces the current image with a new image. Areas where 
the pattern memory is in the new image erase the parts of the current 
image that were in that area. 



Figure 5-19 shows boxes written with replace writing in which part of the 
shaded area of the upper box has been replaced with the shading pattern 
of the lower box. 
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///////// 

//, 
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//, 
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ERASE WRITING 



Figure 5-18 Erase Writing 



■ tttttttt 

///////// 
//a\\\\\\\n 

//a\\\\\\\\ 
//a\\\\\\\n 

//\\\\\\\\N 

REPLACE WRITING 



Figure 5-19 Replace Writing 
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Overlay Writing 

W(V) 

This command writes a new image on top of the current image, wherever 
the pattern memory is 1, without erasing any part of the current image. 
Blank areas in the new image and areas where the pattern memory is 
have no effect on the overwritten area. This is the default option in the 
VT125 graphics processor. Figure 5-20 shows boxes written with overlay 
writing in which part of the upper box is written with both its original pat- 
tern and also the new pattern of the lower box. 

Foreground Planes 

W(F <integer>) 



<integer> 


= 


= no planes 




1 


= plane 1 




2 


= plane 2 




3 


= planes 1 and 2 



Any pixel can have four choices of appearance because there are two bits 
of memory for each pixel in the graphics processor. This command gives 
you control over the individual bits for each pixel in writing commands. 
(Screen erase always clears all bits.) 



•titttttt 
///////// 

//xxxxxxxw 

//XXXXXXXW 

//XXXXXXXW 

//<XXXXXXW 

\\WW\W 

OVERLAY WRITING 



I ! 



\ L 



Figure 5-20 Overlay Writing 
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Each of the 196,608 pixels in the graphics processor has two bits in the 
display memory. Each bit is in one of two identical planes of bits that have 
addresses that correspond to the display's pixel addresses (Figure 5- 
21). The graphics processor uses both bits when it displays each pixel. 

The two bits hold an address that selects one of four intensities and col- 
ors that the graphics processor can display at one time. These intensities 
and colors are set with the screen map control and are stored in the out- 
put map. The address stored in a pixel's two bits controls which of the 
four intensities and colors that the pixel has on the display. 

The foreground plane command lets you write each of the bits individually 
by limiting the write commands to one plane or the other. This has three 
main applications. 

1. Suppose you want to use complement mode (perhaps because its 
effects are reversible by repeating the same command) to change an 
ob'ect from !3 ^intensit v/ 3) to !2. During complement writing, both bits 
are changed. When both bits change (Figure 5-21), the object 
changes from 13 to 10, But if you turn off plane 1 writing and only com- 
plement the low bit, you get 12. Or turn off piane writing, oniy com- 
plement the high bit, and you get 11 from 13. 

2. One plane can hold a fixed image (like a graph grid) and the other 
plane can hold overlays that you can write in replace mode without 
redrawing the grid. 

3. Another application for the foreground planes command is the alter- 
nate display (including blinking) of two graphic images. The graphics 
processor takes a noticeable amount of time to draw most images 
into its memory. This drawing time makes blinking or other closely 
timed visual effects difficult to do. However, if you can afford to use 
only two colors or intensities in your images, you can use the two 
foreground planes as two separate graphic memories that can be 
drawn in with full pixel resolution. 

Figure 5-21 shows the process of writing to the graphic memory with pi- 
xels controlled by the writing commands. The writing commands select 
the individual pixels to be written, the pattern controls whether the se- 
lected pixel changes or not, and then the foreground plane command con- 
trols which of the two planes can be written. The four addresses that the 
two bits form in the planes are shown for pixels (x,y), (x,y+1), (x,y+2), 
and (x,y + 3) in Figure 5-21. These addresses point to the four values of 
intensity and color stored in the output map. 

Refer to Figure 5-21 to select the correct plane to write. Complementing a 
pixel means that the two bits in memory for that pixel are changed to their 
opposite values. Complementing both bits means that if the intensity is 13, 
its complement is 10, and if the intensity is 12, its complement is 11. 
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1 


3 
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GREEN 
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2 
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RED 





1 
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DIM 
GREY 
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DARK 


DARK 
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OR 
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- 


i 
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WRITING 
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CONTROL 
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W(F1) 
W(F2) 
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1 

1 
1 1 


NONE 
PLANE 
PLANE 1 
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Figure 5-21 Foreground Planes and the Output Map 



Refer to the binary to decimal conversion and the output map in Figure 5- 
21. Changing from 13 (white or green) to !2 (light grey or red) is a one bit 
change in plane with no change in plane 1. But complement changes 
the bits in both planes. By using the foreground planes command to turn 
off writing to plane 1 (W(F1)), you can use the complement command to 
change pixels from 13 to 12. 

Remember to restore writing to both planes when you finish single plane 
writing. 



Foreground Intensity and Color 

W(Kinteger» or W(l«letter)) 

or W(l(H<hue>L<lightness> S<saturation>)) 



This command determines how new graphic objects will appear. The ap- 
pearance is selected from four values in the output map. Another com- 
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mand (Screen Output Map Definition, page 147) loads the output map. An 
integer specifier in this command selects one of the four output map val- 
ues. A letter or HLS specifier makes the graphics processor compare the 
specifier with the four values stored in the color output map. The location 
in the output map that holds the color output map value that is closest to 
the foreground definition then becomes the foreground value for a color 
display. The same numbered location in the mono output map provides 
the mono foreground intensity. This command cannot store a value in the 
output map but only selects from the available choices. If the letter or HLS 
specifier in this command is too different from the current output map val- 
ues, the graphics processor may not find a close enough value and may 
give unpredictable results. 

Any pixel can have any of the four values of monochrome intensity (for the 
internal monitor) and color hue, lightness, and saturation (HLS for the ex- 

terilcll UUiOr iiiuniiui^. nuwcvci, vnc vaiuc in iuc nicifj 10 uoc<j db ilis iJeioFv 

ground specifier (refer to Screen Background S(l) and Screen Erase S(E) 
on pages 146 and 145). Any object drawn with the background color or 
intensity should be drawn on top of another object or it will not be visible. 

Any pixel can have four choices of appearance because there are two bits 
of memory for each pixel in the graphics processor. Refer to the Fore- 
ground Planes Command on page 130 for control over the individual bits 
for each pixel. 

The default value is 13 or l(G) or l(L100). 



Pixel Vector Length Multiplier 

W(M <multiplier>) 

This command sets the number of pixels that pixel-related position and 
vector commands move or draw in one step. The default and minimum val- 
ue is 1 pixel, and the maximum is 255. (Larger values modulo 256; is set 
to 1.) 

Negative Writing 

(N 1) = negative on (N 0) = negative off 

This command inverts the effect of the pattern memory. For writing com- 
mands that use the pattern memory, where the memory is 1, the back- 
ground value is written, and where the memory is 0, the foreground value 
is written. 
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Shading 

iii656 Commands ict yOU fiii the niSiuG O'f a graphic GbjeCi wiih ihe same 

command used to describe the outline of the graphic object. When shad- 
ing is on, the vector and curve commands operate as usual. But starting 
at each pixel on the vector or curve path, the graphics processor draws a 
line to the shading reference line. The graphics processor does not auto- 
matically make sure that arbitrary areas are completely and correctly 
filled. You must make sure that the correct reference lines are specified 
to get the shading effect that you want. The shading reference line is the 
horizontal line whose Y-coordinate is specified when shading is turned 
on. The default shading reference is the current Y-coordinate. You can 
specify a different shading reference line in the shading command. 

The default writing pattern used when writing the shading lines is the cur- 
rent writing pattern, which also has a default value of all 1's. You can 
specify a text character from any of the graphic processor's character 
sets to be used as the shading pattern. Such shading can be used for 
area fill. 

Shading with a pattern can provide density or "half-tone" effects. If you 
are limited to two intensity values, as for example with the LA34-VA hard- 
copy printer, you can get grey scale effects by shading with different den- 
sity characters. Use the character cell controls to define a set of charac- 
ters that have different numbers of pixels dark, and use them as shading 
characters. The same technique can let you mix colors at the pixel level. 
Define characters that have the same number of pixels dark but that have 
the pixels offset from character to character. Then overlay write the 
graphic object with the different shading characters using a different fore- 
ground color for each character. 



Shading On or Off 

W(S1) = shading on 
W(SO) = shading off 

This command turns shading on for area fill. The current Y-position is the 
shading reference line, unless you include the reference line command. 
The S(E) command turns off shading and sets the shading reference line 
to the current position. 



Shading Character 

W(S shading character') 

This command turns shading on (same as S1) and uses the shading char- 
acter in single or double quotes to provide a particular pattern for area 
filling. (Refer to Patterns on page 136.) Use the text command to select a 
character size or character set before specifying the shading character. 
When characters from the character set are being used as a shading pat- 
tern, only the first eight (of ten) lines of character pattern are used. 
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Shading Reference Line 

W(S [,<y-position>]) 

Including a Y position in a shading command sets the shading reference 
line to the needed position to properly fill the graphic object to be drawn. 
This command is used with the Shading On or Shading Character com- 
mands. Used by itself, this command turns shading on and clears the 
shading character (same as S1). 

Shading is drawn vertically from pixels on the outline of a graphic object 
to the reference line. If that line is in the wrong place, the shading can 
cover parts of the graphic object. For example, a reference line that is 
above a circle will cause a solid U shape to appear. The reference line 
needed for a circle is in the middle, where the x dimension is largest. 

Other graphic objects can be more difficult to shade, particularly if they 
are concave on their left or right sides. (Figure 5-22). A general rule is io 

uidw ouvii OUjov^io hi iwu \ji iiiuic oc7\_riivji 10, puiliiivj liic oiiauiiivj iciciciH/C 

line above one section and below the other. Shading patterns are always 
aligned everywhere in the display, so objects can appear continuously 
shaded even if they are generated in separate operations. 

Shading with patterns (using the W(P) commands) gives horizontal pat- 
tern lines. This is because the command to shade to a reference line ac- 
tually draws a series of vertical vectors to that line, using the pattern. 

The S(E) command turns off shading and sets the shading reference line 
to the current position. 



SHADING DRAWS FROM GRAPHIC OBJECTS 
OUTLINE TO SHADING REFERENCE LINE. 



SHADING REF= 
[,100] 



START 

POSITION 

FOR EACH P[100,200] 

SECTION 



SHADING REF = 
[,300] 



1ST SECTION 




V[+100] [+100,-100] 



V[+100] [+100,+ 100] 



2ND SECTION 



Figure 5-22 Selecting a Shading Reference Line 
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Patterns 



raileffis aiiOw you 10 vary uiO appearance Of lines aiiu SnaOOQ areas in a 

graphic object. The typical drawing process sets all pixels in the graphic 
object either to one of three foreground intensity (or color) values or to 
the background value. A pattern keeps some pixels of the graphic object 
at the background value while the rest change to a foreground value. The 
pattern does not have to be related to the graphic object's outline. 

Patterns are stored in memory and read during a write operation to con- 
trol the appearance of pixels in graphic objects. For example, a vector 
command may write a series of pixels in a line on the display. As the pi- 
xels are written, the pattern memory is read bit by bit to determine wheth- 
er a corresponding pixel should have the foreground or background in- 
tensity. The shading pattern is also controlled by the pattern memory. 

The memory is 8 bits wide, and its default contents are all 1's (pattern 
P1). Other patterns can be loaded into the pattern memory, including 
standard patterns selected by number (select standard pattern), or your 
own pattern loaded by its bit pattern (specifiy binary pattern). 



Select Standard Pattern 

W(P <pattern number>) 

This command selects a pattern for drawing the outlines of graphic ob- 
jects. The patterns included in the VT125 graphics processor are listed in 
Table 5-9. 

(Patterns 6 through 9 are reserved for future standardization, but are dis- 
played in the VT125 as separated dots so they are visible.) 

PO = 00000000 

lllii;l:i:i:ooi;dp 

P6 through 9 = 10001000 
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Specify Binary Pattern 

W(P <binary pattern>) 

A binary pattern is a 2- to 8-bit pattern that you can set with 1s and Os. 
When the graphics processor draws on the screen, bits that are set to 1 
are drawn, and bits that are set to appear as gaps in the line. (If nega- 
tive writing is on, the effects of 1s and Os are switched.) 

A maximum of 8 bits can be specified for the pattern memory. During the 
drawing of graphic objects, groups of 2, 4, or 8 bits are repeated as full 
subunits. Table 5-10 illustrates the repeat methods. 

Table 5-10 2-, 4-, and 8-Bit Binary Pattern Repeats 

/Rit Mumhari Dattarn DanaataH fCnarae fnr f*laritvfl 

12345678 12345678 12345678 12... 



Groups of 3 are repeated twice and then followed by the first two bits of 
the group before starting again. Groups of 5, 6, or 7 are displayed once 
and then followed by the first 3, 2, or 1 bits of the group before starting 
again. Table 5-11 illustrates the repeat methods. 

For example, P1 100 draws lines dashed with equal gap and mark spac- 
ing. P1 11001 11 draws dashed lines with marks three times as long as 
gaps (because of the pattern repeat). P101 draws a pattern 
1011011010110110 (note that the 3-bit pattern is not cyclic over all 
groups of 3 bits). 

For more variations, use the pattern multiplier command. 



Table 5-1 1 3-, 5-, and 7-Bit Binary Pattern Repeats 

Pattern 

(Bit Number) Pattern Repeated (Spaces for Clarity) 

123 123 123 12 123 123 12 123... 

S^Sii ? :^f T H ; H^ ;; ^ 1 2345 123 12345 123 12345... 
10$^ : mO. 123456 12 123456 12 123456... 

'■S^^^ ; M/^ ; W ; ^^23A5&7 1 1234567 1 1234567... 
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PATTERN MEMORY 



11101010 



MULTIPLIER = 2 



PATTERN STARTS HERE AT 
-BEGINNING OF WRITING COMMAND 
OR P[]. 



DISPLAYED LINE 



DARK AREAS REPRESENT PIXELS THAT ARE CONTROLLED BY ONE'S. 
LIGHT AREAS REPRESENT PIXELS THAT ARE CONTROLLED BY ZERO'S. 



Figure 5-23 Pattern Memory and Multiplier 

Set Pattern Multiplier 

W(P (M <pattern multiplier )) 

This command sets the number of pixels affected by each bit in the pat- 
tern memory. The minimum value is 1 pixel and the maximum value is 16. 
(0 does not change the setting. All other values set the multiplier to 16.) 
Figure 5-23 shows the pattern memory and multiplier in operation. The 
default multiplier is 2 so the interaction of the write modes and some pat- 
terns does not prevent graphic objects from appearing the way you want. 
This makes odd-y simulation work to let a square have the same number 
of addresses in both axes. 

Custom Writing Control Definition 

W(W<i>(P<j>,N<k») 

This command defines the values that replace a specific value of current 
contents at a pixel location. The contents of the pattern memory selects 
which of the two values is used. The command must be expanded to de- 
fine the complete writing control. Numbers are in the range to 3. 

<i> = current pixel contents (repeat for through 3) 
<j> = writing value (0 - 3) if pattern memory bit is 1 
<k> = writing value (0 - 3) if pattern memory bit is 



The VT125 has several writing controls that define the effects of a writing 
operation on the display. Standard writing controls provided include, for 
example, complement and overlay. 
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Figure 5-24 Custom Writing Control Command 



Each of the standard writing controls is a predefined shorthand use of the 
W(W) command. You can create your own writing control to get the effect 
you want. The W(W) command lets you define writing actions for single 
pixels based on every possible combination of bit plane and pattern mem- 
ory contents. 

Figure 5-24 shows that the hardware associated with the W(W) command 
is a one of eight decoder and an eight-by-two bit memory. The decoder 
has two inputs. The current pixel in the display bit map supplies the two 
low bits. The current bit in the pattern memory supplies the high bit. The 
eight outputs from the decoder select eight possible writing choices for 
the current pixel. 

The W(W) command loads the eight-by-two bit memory with your choices 
for new information to write into the current pixel location. All the numbers 
in the command represent 2-bit numbers in the range to 3. The com- 
mand introduction is W(W). The next number <i> is the current pixel val- 
ue. All four possible current pixel values are inputs to the 1 of 8 decoder, 
so the command must be repeated four times to change the complete 
memory. The rest of the command is (P<j>,N<k>). P and N are keylet- 
ters for the contents of the pattern memory. <j> and <k> are numbers 
representing the new information to be written. For a given <i>, if the 
current bit of the pattern memory is 1 (P for positive), then <j> is the 
value that is written. If the current bit of the pattern memory is (N for 
negative), then <k> is the value that is written. 
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For example, if the current pixel is and you want to change it to 3 if the 
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command is W(W0(P3,N0)). 

W(R), W(C), W(V), W(E), W(N)M, W(F<n>) and W(Kn>) are actually 
shorthand expressions for forms of the W(W) command. The following are 
shorthand expressions and their equivalents. 

W(C) is: 

W(W 0(P3,N0) 1(P2,N1) 2(P1,N2) 3(P0,N3)) 

W(F1,R) is: 

W(W 0(P1,N0) 1(P1,N0) 2(P3,N2) 3(P3,N2)) 

W(F3,V,I2) is: 

W(W 0(P2,N0) 1(P3,N1) 2(P2,N2) 3(P3,N3» 

Specifying any shorthand form sets the complete map to the appropriate 
value. When you use W(W), only those choices you specify are filled in. 
Unspecified values remain as previously set. 

Table 5-12 is a summary of the writing controls. 
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Table 5-1 2 Writing Controls Summary 

W { (C) I Complement 

{(E) ! Erase 

j (R) } Replace 

{ (V) } Overlay 

! (F foreground planes>) } = no planes 

{ } 3 = planes 1 & 2 

{ } Foreground Intensity 

{ (1 or (D) ) ! Dark or Dark 

{ 1 (R) ) } Dim grey Red 

{ 2 (G) ) } Light grey Green 

{ 3 (B)) ! White Blue 

{ (Y) ) } Yellow 

{ (M)) } Magenta 

{ (W)) i White 

{ (I (H <hue angle> ! 

{ L < lightness percent> J 

i S <satu ration percent)) } 

i (M <multiplier>) } 

{ (N 1) } = negative on 

{(NO) } = negative off 

{ (S 1) J = shading on 

{(SO) } = shading off 

{ (S [.shading reference]) } 

{ (S 'shading character") ! 

{ (P <binary pattern>) } Enter pattern 

{ (P <pattern number>) } Use VT1 25 pattern 

{ (P (M <pattern multiplier^) J 

{ (W<i>(P<j>,N<k>)) } Define write control 
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SCREEN CONTROLS 



IICOC UUIII 



iaiiub cm cut trie (JOifijjitjte SCfetJfi Of ii'iti 



^o ai the same 



time. This section explains the controls for positioning and addressing the 
complete image, color and background of images, timing of actions, and 
production of hardcopy output. All screen control commands begin with S. 

Initial Screen Control Defaults 

When the VT125 graphics processor first powers up, many of the screen 
controls have default values assigned. The defaults allow the graphics 
processor to respond immediately to many of a novice ReGIS user's com- 
mands. General applications should include screen control specifications 
at the beginning of each graphic image. These specifications make sure 
that the graphics processor is in the correct state when the image is gen- 
erated. The defaults are: S[0,0] (A[0,0][767,479], 10, S1, TO, H(P[50,0]). 
(Refer to page 150 for M defaults.) 



Screen Scrolling 

S<pv> or S[<position>] 

A window (represented by the display screen of the VT125 terminal) 
moves around the screen image. The window moves its top left corner by 
a relative amount if the specifier is a relative position or a pixel vector, or 
to an absolute position (measured from the origin) if the specifier is an 
absolute position. Pixel multipliers apply if the pv form is used, and the 
origin is determined by the screen addressing option if the position form is 
used. (Refer to the Position section and Screen Display Addressing in this 
chapter.) Display addresses stay with the image so the image stays in the 
same position relative to the origin (Figure 5-25). 









1 


SU00, 1001 

2345< 


378 






r767,5in 



DISPLAY WINDOW'S TOP LEFT CORNER MOVES TO 
ADDRESS [100,100] . SCREEN SCALE=2 



Figure 5-25 Scrolling the Display Window 
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If the screen scale command changes the display of an image, this com- 
mand moves the display window to allow any part of the image to be seen. 
Also, the image scrolls through an address space of 256 pixels vertically 
(represented by 512 addresses for odd-Y simulation) and wraps from top 
to bottom. The visible area is only 240 pixels (or 480 addresses) so verti- 
cal scrolling allows all of the image to be seen. The image wraps horizon- 
tally at pixel (and address) 768. 

Screen Display Addressing Definition 

S(A[<position>][<position>]) 

The addressing option is a compatibility feature. It allows the VT125 to 
display graphic images that are created for other ReGIS devices and have 
different resolutions or address orientations. Use a host system's soft- 
ware to do scaling (size) transformations and maintain the performance of 
the graphics processor. Scaling transformations done by the graphics 
processor have roundoff errors, resulting distortions, and generally pro- 
duce smaller images tuan expected. Axis transiormations vor example, 
moving the origin to the lower left corner) may be done by the graphics 
processor because they have little effect on graphics processor perform- 
ance and do not cause distortions or size changes. 



NOTE: Pixel vector directions do not change with the addressing option. 

The first <position> is the address you want the upper left corner of the 
display to have, and the second <position> is the address you want the 
lower right corner of the display to have. If either or both <position> are 
missing or illegal (negative), the entire option is ignored and the display 
coordinates stay unchanged. The graphics processor defaults to a speci- 
fication of A[0,0][767,479]. 

If the right margin value is smaller than the left margin value, the x coordi- 
nate increases to the left. If the bottom margin value is smaller than the 
top margin value, the y coordinate increases going up (Figure 5-26). 
There are no absolute negative coordinates in ReGIS, so do not specify 
an addressing range that has negative coordinates. 

The graphics processor uses odd-Y simulation. Odd-Y simulation means 
that although the vertical resolution of the graphics processor is 240 pi- 
xels, each pixel can be addressed by both an even number and the next 
higher odd number. This system allows compatibility with higher resolution 
displays and lets a given number of addresses in the x direction be the 
same physical length as the same number of addresses in the y direction. 
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Figure 5-26 Axis Address Transformation 



ReGIS does not reject addresses that are outside the area of the dis- 
playable screen. ReGIS accepts these addresses for compatibilty with fu- 
ture devices that have a larger displayable area than the graphics proces- 
sor's screen. By accepting these addresses ReGIS also allows proper 
computation of graphic objects that partially extend into the borders of the 
screen area. The VT125 has a computing address space with full resolu- 
tion that extends at least one full screen size in each direction (Figure 5- 
27) provided that the screen display addressing specification is less than 
[16383,16383]. If no computing address space is needed outside the dis- 
playable screen, the addressing screen display specification can be as 
large as [32767,32767]. 



Beyond a certain address, which varies according to the address specifi- 
cation, the graphics processor wraps graphic objects into the opposite 
side of the screen. Wrap addresses greater than 32767 are invalid. The 
wrap addresses can be calculated with the formulas in Table 5-13. 

The current position, as reported by the report command, is given in the 
coordinates set by this option. If a command has moved the cursor into 
the address space above or to the left of the screen, it is in "negative" 
address space. ReGIS cannot use negative addresses but the graphics 
processor reports the location of the current position in the form: 65536 
+ negative location. For example, a position 100 pixels to the left of [0,0] 
is computed as 65536 + (-100) = 65436. You cannot use this form to 
address the negative address space. Only relative movements from posi- 
tive addresses can move the current position in the negative address 
space. The graphics processor's ability to compute locations in the nega- 
tive address space prevents distortions or improper offsets at the nega- 
tive boundaries, it cannot be used to create images for display. 



ReGIS PROGRAMMING 145 



NEGATIVE 
ADDRESS - 
SPACE 



SCREEN 16383 



-16383- 



32767 



POSITIVE 
ADDRESS 
SPACE 



■ 32767 ■ 



Figure 5-27 VT125 Addressing Range 

Table 5-1 3 Wrap Address Formulas 

Horizontal wrap = (X-address option specifier X 4096/767 - 1 
Vertical wrap = (Y-address option specifier X 4096/511 -1 



When the addressing option is set to be any value except the default, in- 
teger scaling is used. It is used so that there is a constant integral rela- 
tionship between the number of pixels that are displayable on the screen 
and the number of pixels that can be addressed by the selected coordi- 
nates. The result is that images prepared on low resolution devices trans- 
fer to other low resolution devices with constant interval step sizes that 
may waste up to half of the receiving device's display area. 

Screen Erase 

S(E) 

This command sets the complete screen area to the background intensity 
and color value that was selected by the screen background definition 
(S(l)) command. (The range of values for S(l) is set by the screen output 
map definition (S(M)) command.) The current cursor position is not 
changed. Shading is turned off and the shading reference line is set to the 
current position. No other writing controls are affected. Any curve inter- 
polation is terminated and all (B), (S), and (E) coordinate blocks are 
cleared. The contents of the output map (refer to Screen Output Map) are 
unchanged. 

The E keyletter has a restriction in its formatting with other commands. 
ReGIS understands a string of numbers followed by E to mean exponential 
(scientific) notation. Therefore, a comma is necessary in the command 
S(I0,E) to cause a screen erase to intensity 0. 
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Screen Hardcopy Output 

S(H (P[<position>]) [<position>][<position>]) 

This command generates a hardcopy image of the screen area within the 
rectangle defined by the two position specifiers. If only one position speci- 
fier is given, that position and the current cursor position define the rec- 
tangle. If no position specifiers are given, the whole visible screen is out- 
put. The output image is scaled as the screen is scaled by the S(S) 
command, and the range of addresses printed is defined by the two posi- 
tion specifiers. 

S(H(P[<position>])) is a command that specifies the location of the up- 
per left corner of the hardcopy image on the paper. The position is mea- 
sured from the left margin at the current vertical printhead position. The 
value set by the P option stays the same until it is changed by another P 
option. The default position for hardcopy output is [50,0] to horizontally 
center the image on 8.5 inch paper. Unless the P[<position>] option is 
followed by other position arguments, it only sets the image corner loca- 
tion without causing a hardcopy printout. If it is followed by arguments or 
another H keyletter, it causes a printout. 



Refer to the Media Copy control sequence in the Received Character Pro- 
cessing chapter (Chapter 4) under VT125 Communication and Graphic 
Control Sequences. With Media Copy, the hardcopy image output can be 
sent either to the auxiliary port for printing, or to the host for storage. 

NOTE: Entering and exiting SET-UP cancels a hardcopy command. 

Most printers can only display two intensities, on and off. The VT125 can 
display four monochrome intensities. To generate hardcopy output, the 
VT125 puts a dot wherever there is a nonzero intensity according to the 
monochrome output map. Refer to Shading in Writing Controls on page 
134 for a method for getting grey scale hardcopy. 

Screen Background Definition 

S(l<integer» or S(l(<letter>)) 

or S(!(H<hue> L<!ightness> S<saturation>)) 

This command selects the appearance of the background. The back- 
ground is the intensity or color that the screen has when it is erased 
(S(E)) or when a graphic object is written that specifies background writ- 
ing. The background is selected from a range of four values that were en- 
tered into the output map by the Screen Output Map Definition (S(M)) 
command. An integer specifier selects one of the four output map values. 
A letter or HLS specifier makes the graphics processor compare the 
specifier with the four values stored in the color output map. The location 
in the output map that holds the color output map value that is closest to 
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the background definition then becomes the background value for a color 
display. The same numbered location in the mono output map provides 
the mono background intensity. 

This command cannot store a value in the output map but only selects 
from the available choices. If the letter or HLS specifier in this command is 
too different from the current output map values, the graphics processor 
may not find a close enough value and may give unpredictable results. 

The default value is 10 or l(D) or l(LO). 

Screen Output Map Definition 

S(M<n> (<mono lightness>) (A H<hue> L<lightness> 
S<saturation>)) 

<n> is 0, 1, 2, or 3 to select the output map section that stores the defi- 
nition. 

(<mono lightness>) is an HLS specifier with only the L or lightness 
specifier given, or a letter specifier (Table 5-14). It selects the intensity of 
a given pixel on the monochrome monitor in the VT125 terminal. The four 
possible lightness values (dark, dim grey, light grey, white) are on a per- 
cent scale that is divided into four ranges: 0-24, 25-49, 50-74, 75-100. 
Any percentage within a range selects the lightness value for that range; 
for example, L65 selects the third value: light grey. Values are truncated 
to their integer part, so 24.99 is in the 0-24 range while 25.00 is in the 
25-50 range. H and S specifiers are ignored in the monochrome part of 
the command. 



Table 5-1 4 RBG or HLS Colors in the VT1 25 



Color 



RGB 



Dark 


D 


Blue 


B 


Red 


R 


Magenta (+B) 


M 


Green 


G 


Cyan(B+G) 


C 


Yellow (R+G) 


Y 


White (R+G+B) 


W 



HLS 

iiiiiisisiiii 

HO L50S100 
H120L50S100 
H60 L50S100 
H240 L50S100 
H300 L50 S1 00 
H180 L50S100 
L100 



Mono Intensity 
Defined by 
RGB Specifier 

Dark 
Dim grey 
Light grey 
White 
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L=72-85 



MAGENTA 



©L = 86 -100 (COLOR) 
L = 75 -100 (MONO) 



YELLOW 



MAGENTA 



BLUE 



YELLOW 1 




L = 0->14 (COLOR) 
L = 0-24 (MONO) 



NOTE: DEGREE SPECS DEFINE THE SEGMENT FOLLOWING 
COUNTER CLOCKWISE. 

* THERE ARE FOUR MONO INTENSITIES, THEY ARE 
SHOWN IN SMALL CIRCLES. 



Figure 5-28 Colors in the VT1 25 
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(A H<hue> L<lightness> S<saturation>) is an HLS specifier that se- 
lects the intensity of a given pixel of an external (Alternate) color monitor. 
Many different colors can be displayed using the HLS specifiers because 
the six bits of information that each output map holds for the color monitor 
can describe any of 64 combinations. Refer to Figure 5-28 for an illustra- 
tion of the range of hues available for different levels of lightness and sat- 
uration. A more limited set of colors can be selected using the letter spec- 
ifiers shown in Table 5-14. Appendix G explains the HLS specifier system 
in more detail. 

If the graphics processor does not understand a specifier (perhaps be- 
cause it was incorrectly formatted) the output map involved is set to a 
default light grey: H L50 SO. There is a set of default values for the output 
map that are used at power-up. The default values can be described by 
the command in Table 5-15. 

The VT125 displays color and brightness by displaying one of four preset 
vaiues for each pixei on the screeen. The VT125 can display each pixel 
on the screen with a different hue, lightness, or saturation. However, it 
can do this with only four different combinations at one time. That is, any 
pixel can be different from its neighbors, but there can only be four differ- 
ent pixel colors on the screen at one time. 

The VT125 has a pixel memory and an output map. For each pixel, there 
are t w0 bits of information. These pairs of bits are in two separate but 
closely connected planes of addressable locations. (Refer to Figure 5-21 
in Writing Controls.) The pairs of bits represent the four numbers 0, 1,2, 
and 3 when their binary values are decoded. (The foreground planes com- 
mand has a more detailed discussion of this subject.) 

Each of the four numbers is the address of one of four output map loca- 
tions. Each output map location holds a description of one intensity for 
the monochrome display in the terminal, and one color for the external 
color monitor. When the pixel memory is being displayed, each pixel bit 
pair indicates the output map location that holds the pixel's appearance 
on the display screen. 



Table 5-1 5 Default Output Map Values 

S(M0 <L0) (A LO) 

1 (L25) (A HO L50S100) 

2 (L50) (A H120 L50 S100) 

3 (L75) (A H240 L50S100)) 
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Each of the four output map locations holds one of four levels of intensity 
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one of 64 different values of lightness, hue, and saturation for the color 
monitor. The information in each of the four output maps can be set using 
the mapping command with RGB letters, or HLS specifiers. Table 5-14 
lists the specifications for the colors available by RBG letter code in the 
VT125. Many more colors can be defined with HLS. Figure 5-29 shows the 
default values stored in the output maps for the internal monochrome and 
external color monitors. 



Specifying anything with A changes a color, specifying anything without A 
changes only the monochrome map. Figure 5-30 shows sample defini- 
tions and the resulting maps. 



MONO 



WHITE 



LIGHT GREY 



DIM GREY 



DARK 



COLOR 



GREEN 



RED 



BLUE 



DARK 



Figure 5-29 Default Output Map 



S(M1(AW)) = 
MONO 




COLOR 


(NO CHANGE) 


1 


WHITE 


S(M2(L50) (A H 
MONO 


L50S 


100)) = 

COLOR 


LIGHT GREY 


2 


BLUE 


S(M3(L100)) = 
MONO 




COLOR 


WHITE 


3 


(NO CHANGE) 






MA-9462 



Figure 5-30 Sample Output Map Definitions 
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Screen Scale 

S(S<scale>) or S(S(X<scale>Y<scale>)) 

This command takes the contents of the graphic memory and changes 
the portion of the memory that appears on the screen at any one time. If 
<scale> is a number, for example S(S2), use that number as the scaling 
value for both the X and Y dimensions. To scale differently in X and Y, put 
X<number> and Y<number> in parentheses at <scale>, for example 
S(S(X2)). Legal values in the VT125 are 1 for usual size and 2 for double 
size. Values less than 1 are understood as 1 and values greater than 2 
are understood as 2. Dimensions not specified do not change. When the 
image is enlarged, the upper left corner of the image stays in the same 
place, so you must offset the display with the scrolling command to see 
the other areas of the display. Refer to Screen Hardcopy Output for the 

ciici/io ui o^aiuiy vjw men ouun nai iu. 

Screen Time Deiay 

S(T<ticks» 

The time delay option causes ReGIS to delay the processing of the next 
command for the specified amount of time. Ticks are either 60ths or 50ths 
of seconds, depending on the Power SET-UP feature setting. The largest 
possible number is 255, which is approximately 4 or 5 seconds. 

Table 5-16 is a summary of the screen controls. 
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(A [<position>] [<position>]) 


} Display addressing 


(E) 


) Erase screen 


(H [<position>l [<position>]) 


} Hard Copy (corner 




} positions optional) 


(H (P[<position>J)) 


} Set hard Copy Offset 




} Background Intensity: 


(» or (D) ) 


.-'} Dark or Dark 


1 (R)) 


1 Dim grey Red 


2 (G)) 


} Light grey Green 


3 (B)) 


} White Blue 


(Q) 


) Cyan 


(Y)) 


} Yellow 


(M)) 


} Magenta 


(W)) 


} White 



{ or 

{ (I (H<hue angle> 

{ L <lightness percent> 

{ S <saturation percent>)) 



S(M<n> (<mono HLS>) (A<color HLS>)) 



{ 



} Output 
} Mapping 



(S <scale>) 

(S (X<scale>Y<scale>)) 



(T <ticks>) 



} Time Delay 
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MACROGRAPHS 

A macrograph is a character string substitution utility provided in ReGIS. 
Strings are command strings or any other string of characters stored in 
the VT125 memory and then substituted in another command string. Gen- 
erally, a macrograph is a part of or a complete ReGIS command string 
that is used often. ReGIS inserts the contents of the macrograph in the 
command string at the position where the macrograph is invoked. 

The 26 letters of the alphabet are the keyletters for defining and invoking 
macrographs, so 26 macrographs can be defined. Each macrograph can 
be as long or as short as needed. There are at least 5000 characters of 
storage available in the VT125 memory for all macrographs. 

A macrograph can invoke another macrograph but not itself. A mac- 
rograph cannot be defined inside a macrograph (the inner terminator ter- 

1 1 iii idico li ic uuici uciiiiiiiwii/ isi iii a. ljuviou ouiii^ \uio uoi u 

vocation characters become part of the text in a quoted string). 



Clear All Macrographs 

@- 

This command has the same effect as defining all 26 macrographs as null 

nr pmntv if this rnmmflnrl is ineiHe a mar-rnnranh the mnrrnnrnnh ic oom- 

pleted and then all macrographs are cleared. 

Macrograph Definition 

@:keyletter character _string @; 

@: (commercial at-sign and colon) - These characters start the mac- 
rograph definition. 

keyletter - This character defines one letter of the alphabet to be the 
name of the macrograph. ReGIS ignores the case of the letter. If a 
macrograph with the same keyletter was previously defined, it is cleared 
before the new definition is saved. A null definition (no characters in the 
character string) is legal and clears any macrograph with that keyletter. 

character_ string - These characters specify the characters saved as 
the macrograph. All characters in character_string are saved including 
all control characters. The macrograph definition start and end charac- 
ters are not included with the saved characters. Character_string has no 
fixed maximum length, but the number of characters saved in all mac- 
rographs should be less than 5000. 
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@; (commercial at-sign and semicolon) - These characters end the 
macrograph definition and returns ReGiS to ihe command ievei it had be- 
fore invoking the macrograph. The semicolon does not synchronize the 
command level the way it does at any other place in the command string. 
Do not put a control character between these two characters. 

Macrograph Invocation 

@ keyletter 

The @ sign and one of the 26 keyletters invokes the macrograph with that 
name and inserts the character string in the ReGIS command string in 
place of the @ and keyletter. A macrograph can not be used to supply a 
keyletter for an @ sign: @@ is illegal. Invoking an empty macrograph is 
not an error. 



Table 5-17 is a summary of the macrograph commands. 

Table 5-1 7 Macrograph Command Summary 

@{ I Clear all macrographs 

{ : keyletter character_string @; } Define macrograph 

{ keyletter } Invoke macrograph 
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CHARACTER CELL CONTROLS 

The VT125 graphics processor can write text with up to four character 
sets at one time. Each character set has 95 displayable characters. One 
character set is always ASCII but the other three can be loaded into the 
graphics processor's character memory over the communications line. 

Select Character Set for Loading 

L(A<integer>) 

This command selects one of three loadable character set memories in 
the graphics processor for loading. Set is the ASCII character set in the 
VT125 graphics processor and can not be changed. Sets 1, 2, and 3 can 
be loaded according to the instructions in Load Character Cell. The select 
command can include a name as in Associate Name. 

The load command selects a character set for loading, but the actual 
loading process does not have to foiiow immediateiy. Other commands 
can be performed without changing the selection, in particular, the text 
command selects a character set for writing. This text selection is not the 
same as the load selection and does not change the character set se- 
lected for loading. 

Associate Name with Current Character Set 

L(A"<name>") 

This command gives a name, up to ten characters long, to the character 
set currently selected for loading. This name is used for reporting the cur- 
rent character set (refer to Reports on page 157). Both <name> and 
<integer> may be specified in the same option, but if <name> is speci- 
fied first, it will be associated with the currently selected set, not neces- 
sarily the one specified by <integer>. 

Load Character Cell 

L"<ascii char>" <hex pair>,...,<hex pair>; 

A character set is 95 cells, with each cell identified by one ASCII printing 
character in <ascii char> enclosed in double ("") or single (") quotes. 
However, if more than one character is in <ascii char>, only the first 
character is used and the rest are ignored. 

Each character cell is 10 pixels high and 8 pixels wide. It is defined by the 
locations of bits in a series of 10 8-bit bytes that are transmitted as 
hexadecimal digit pairs separated by commas. You can load other char- 
acter cells in the set in the same L command by putting the quoted char- 
acter immediately after the last <hex pair> of the previous character 
cell. A semicolon terminates the complete load command. Figure 5-31 
shows a sample cell and its construction. 
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11111111 FF 

10 110 1 99 

10 10 10 1 A5 

110 11 C3 
110 1 1__^ C3 

10 10 10 1 A5 

10 110 1 99 

10 110 1 99 

10 110 1 99 

11111111 FF 



FORMAT: L"a"FF,99,A5,C3,C3 / A5,99,99,99,FF; 

MA-9470 

Figure 5-31 Sample Character Cells 

1's represent light (foreground) pixels in usual (nonreversed) writing. The 
default width for displayed characters using the S<integer> text com- 
mand is 9 pixels. The ninth pixel is copied from the first pixel. If you want a 
dark space between characters, you must either use only the right seven 
bits in each row (like the permanent ASCII character set), or use the ex- 
plicit text size and spacing commands. 

Cells are always loaded one row at a time using hexadecimal ASCII digits 
for the character specifiers. A cell is specified from the top down, with the 
most significant bits in the left digit of the specifier. If more than two digits 
are given for a single line of the character specifier, the digits on the left 
are ignored. If only a single digit is specified, it fills the low order portion of 
the character map line specifier, setting the high order part to zero. If less 
than ten specifier lines are given, the unspecified portion of the cell is 
cleared to zero. 

Table 5-18 shows the format for a complete character set definition. 

Table 5-19 is a summary of the character cell controls. 



Table 5-1 8 Character Set Definition Format 

L (A<integer> "<name> v ] '"ascii character' 

<hex digit>.<hex digit> , <hex digit> 

"ascii character" <hex digit> <hex digit>; 



Table 5-19 Character Cell Control Summary 

L i (A<integer>) | Select for loading 

! (A"<name>") ! Give name to set 
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REPORTS 

This command causes the graphics processor to send information 
through the requesting channel. 

If multiple reports are requested in a single report command or report 
command option, each separate report requested is sent as if it was the 
only report requested. Every report sent ends with a carriage return. 

In a terminal to host environment, make sure that data reported are not 
echoed back to the terminal in a way that could cause errors. For ex- 
ample, a cursor position echoed to the terminal could cause either an un- 
wanted vector or curve element, or an unmatched point specifier. A 
macrograph report that is very long (more than 40 to 50 characters) and 
is echoed back to the terminal, may cause the terminal to hang in a dead- 
lock situation: The terminal refuses (using XOFF) to accept characters 
echoed until the report is com n !ete. If the host cannot acce n t the remain- 
der of the report without echoing it, then the deadlock occurs. 

Report Character Set Selected for Loading 

R(L) 

With this command the character set name is reported back in the same 
form as the option specifier that defined it, for example, (A"Greek"). 

Report Contents of a Macrograph 

R(M«keyletter») 

With this command the macrograph with name <keyletter> is reported 
back headed by a macrograph report indicator "@=<keyletter>". It is 
followed by a macrograph terminator "@;" and followed by a carriage re- 
turn. Any control characters saved as part of the macrograph are also re- 
ported back. If there is no macrograph defined for the keyletter, a null 
macrograph is reported back (no characters), enclosed in the indicator 
and terminator. Include more keyletters in the inner parenthesis for more 
reports. The macrograph report indicator format is ignored if echoed back 
to the terminal. 



158 ReGIS PROGRAMMING 

Report Use of Macrograph Storage 

R(M( = )) 

If there is an equal sign " = " in the command, the report lists the status of 
macrograph storage in the form: 

"<free>,<total>" 

where <free> is the number of characters still available for macrograph 
storage and <total> is the total number of characters of macrograph 
storage provided in the graphics processor memory. Storage in use may 
be calculated by subtracting <free> from <total>. The report ends with 
a carriage return. 

Report Cursor Position 

R(P) 

This command reports the current cursor position in user coordinates as 
set by the Define Display Addressing command (page 143). 

The cursor position is reported as a pair of unsigned numbers, X-value 
first, enclosed in square brackets. 

Table 5-20 is a summary of the report command. 
Table 5-20 Report Command Summary 



R ! (U 


! Set selected for loading 


i 

{ (M(<keyletter>) 

I 


) Contents of macrograph 


UMH) 

i 


} Use of storage 


{ "<free>,<total>" 

{ 


} Reply to Use 

i 


HP) 


"•} Cursor position 
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INTRODUCTION 

The VT105 function set is described in this chapter. It is the same as the 
VT105 described in the VT105 User Guide with the following exceptions. 

1. To enter VT105 mode the control sequence is ESC P t (DCS format) 
and NOT ESC 1. The sequence to exit VT105 mode is ESC \ (ST) 
and NOT ESC 2. 

2. Only one VT105 emulator can exist in a VT125. Accesses to a sec- 
ond waveform generator board (an optional configuration in the 
VT105) through command characters P, Q, R, S, T, X, Y, Z, [, and \ 
are ignored. 

3. The relative positions of the graphics and text display fields are not 
exactly the same as in the VT105. There are always at least 6 VT100 
character positions to the left of the left graphics margin. The width 
of the graphics field with respect to the 80 character VT100 text field 
may be off by one or two characters. 

4. The resolution of the VT105 is mapped into the VT125 display using 
nonuniform dot spacing. Therefore, there may be some small scale 
differences visible in some graph presentations. 

5. The VT105 interactive graphics test does not exist in the VT125 
emulation. The hardware is tested by the VT125 tests. 

6. Some actions performed by dedicated hardware in the VT105 (blank, 
reset, and shade, for example) will take longer to execute in the 
VT125, and may cause a slight difference in performance between 
the machines. 

NOTE: The state of the VT125 cannot be guaranteed if you switch 
between protocols. For example, while it may be possible to use 
ReGIS to add to a VT105 presentation, you cannot be sure that ei- 
ther protocol will be where you left it when you switch between them. 
This is different from switching between ReGIS and text mode, where 
ReGIS stays in the same state until you return. 

159 
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This chapter describes how to: 

Select the graph drawing mode, 

Establish the graph area, 

Establish desired display, 

Load graph data, 

Generate shade lines, cursors, and grid, and 

Enter strip chart data. 

ENTERING GRAPH DRAWING MODE 

ESC P t (033 120 164) switches the terminal to VT105 graph drawing 
mode. The terminal will remain in this mode until ESC \ (033 134) is re- 
ceived. 

DEFINITIONS AND LIMITATIONS 



Graph 



A graph is a series of points 
representing the variation in value 
of two variables: X and Y. For 
each horizontal value(x), there 
can be only one Y value; example, 
a sine wave. 



Graph Marker 



A graph marker is a short vertical 
line that may be programmed to 
mark any point of the graph. Each 
marker represents a specific 
value of X and appears at 
intervals of Y = 240/ 16. As many 
as 512 markers can be placed on 
each graph or histogram for a 
total of 1024 markers (Figure 6- 
1). 



Histogram (shaded graph) 



A histogram in the VT105 is a 
graphic display that has the area 
between the graph line and the 
bottom of the graph drawing field 
intensified. Two histograms can 
overlap and still be discernible. A 
bar graph is an example of a 
histogram (Figure 6-2). 



Shade line 



A shade line (baseline) is the line 
referenced (baseline) for shading 
a graph. One shade line can be 
displayed for each of the two 
graphs. If no shade line is 
established, the graph can be 
shaded to the bottom of the graph 
drawing area (refer to Histogram). 
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Figure 6-1 Graph with Graph Markers 
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Figure 6-2 Histogram Display (Shaded Graph) 
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Horizontal lines/vertical lines 



Horizontal lines and/or vertical 
nnes may ye displayed in the 
graph area to represent set 
values of X or Y. As many as 512 
vertical or 240 horizontal lines 
may be individually displayed on 
the screen. For example, a grid is 
displayed using specific values 
for horizontal and vertical lines 
(Figure 6-3). 



Strip chart 



A strip chart is a graph or 
histogram that permits new data 
to be added to its right side while 
shifting previous data to the left 
(Figure 6-4). Vertical and 
horizontal lines, if present, move 
from right to left as the strip chart 
moves, and wraparound the 
screen as they leave the left 
edge. 



Dual strip chart 



Dual strip chart is a feature that 
allows both Graph and Graph 1 
to pass across the screen. 



Rectangular graph drawing field 



The rectangular graph drawing 
field is one of two aspect ratios 
selectable within the VT105. It has 
a 20 X 10.9 cm (8 X 4-3/8 in) 
graph drawing field compatible 
with previous DIGITAL graph 
drawing terminals (e.g., VT55). 
Refer to Figure 6-5. 



Square graph drawing field 



The square graph drawing field is 
a selectable aspect ratio with a 
16.5 X 11.5 cm (6.5 X 4.6 in) 
graph drawing field. It 

/-» *-\ tm r\rr\4&&r\c* lV\s\ V .. « v ! r* I /*\ ►■* /-i + U» ^^rl 

uuiii|ji^ooco li ic aoaio i^iiyni ai ivj 

provides a greater area outside 
the field for alphanumeric labels, 
grid identifiers, or notes (Figure 6- 
6). 



Graph resolution 



Up to 512 horizontal and 230 
vertical points may be displayed 
per graph in the rectangular graph 
drawing field; 512 X 240 points, 
in the square graph drawing field. 
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Figure 6-3 Example of a Grid Display 




Figure 6-4 Strip Chart Display (Moves From Right to Left) 
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Figure 6-5 Rectangular Graph Drawing Field 
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Figure 6-6 Square Graph Drawing Field 

SELECTING GRAPH DRAWING FIELD 

The VT105 has two selectable graph drawing fields or formats. Both for- 
mats display up to two 512-point graphs having single valued functions of 
X. Either or both graphs can be displayed as a histogram or a strip chart. 
Graphs and histograms can overlap and still be discernible, allowing the 
use of the entire field for both graphs, both histograms, or a graph and a 
histogram displayed together. Both formats display individually program- 
mable horizontal and vertical lines over the entire graph field allowing a 
grid to represent any desired value. Graph markers can be displayed in 
either format. Table 6-1 compares the formats and how each is selected. 

Example 



Character 
Sequence 



Octal Code 
Sequence 



Field 



I space! 

I space space 



1 1 1 040 041 Enable square format 

1 1 1 040 040 Enable rectangular format 



SELECTING DESIRED DISPLAY 

Enabling graphs, histograms, strip charts, and shade lines (baselines) is 
accomplished by loading control register in the VT105; enabling graph 
markers, vertical lines, and horizontal lines is accomplished by loading 
control register 1. The registers are loaded by sending a two or three 
character sequence from the keyboard or host computer. The number of 
characters depends on the type of graph or shade line (baseline) desired. 
The control bits are encoded as 7-bit ASCII characters that are sent to the 
terminal. 
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Table 6-1 Comparison of Graph Drawing Formats 



Feature 


Rectangular 
Format 


Square 
Format 


Graph field 
(maximum) 


20 X 10.9 cm* 
(8 X 4.3 in) 


16.5X1 1.56 cm* 
(6.5 X 4.625 in) 


Graph resolution 
(maximum) 


51 2 X 230 
points 


512 X 240 
points 


Features 

Graphs 

Shaded graphs 
Movable shade lines 
Strip charts 
Vertical lines 
Horizontal' lines 
Graph markers 


2 

2 

1 per graph 

2 

512 

230 

512 per graph 


2 

2 

1 per graph 

2 

512 

240 

512 per graph 


opacs provide^ in 
left margin for 


1 character 
(column 1) 


<j cnaraCisrs 
(column 1-8) 


Character lines 
below graph field: 


1 line 
(line 24) 


none 


Selected on initialize 


Yes 


No 


Program selectable by: 


I space space 


I space! 


Display using previous 
DECgraphic software 
(i.e., VT55) 


Display 
unchanged 


Both height 
and width are 
changed 



* These dimensions come from the VT1 05 specification and are slightly different 
in the VT1 25 emulation. Use them for comparison of the formats only. 



Loading Control Register 

Refer to Table 6-2 to determine the required bits to set in register 0. A 
seven-digit binary code transmits the desired display. The bits are set as 
desired, for example: Bit 2 is set to enable Graph 1: bit is set to enable 
the display. The binary code created is 0100101 (045s). For examples of 
loading register 0, refer to Tables 6-3 and 6-4. 

Table 6-5 can be used to convert the binary codes created for register 
to the program requirements. 

Example 





Octal 






Function 


Code 


Character 


Code 


Enable Graph 1 


045 


% 


0100101 
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Table 6-2 Load Enable Register O Command 

Rectangular or Square Format 

First character: A{101g) 

Second character: variable (See below) 

Third character: variable (See below) 

' Explanation - 

The second character is formed by setting bits where the bits have the following 
functions. 



2nd Character (Register 0) 



Binary Code 
01 XX XXX 



Bit 

6 Always 

5 Always! 



4 If 1 , displays graph 1 as a shaded graph to the bottom of 

the graph field 

(histogram 1) 

3 If 1 , displays graph as a shaded graph to the bottom of 

the graph field 

(histogram 0) 



2 If 1 , displays graph 1 
1 If 1 , displays graph 



If 1 , enables all graphic information to be displayed 



NOTES 

1. Enabling graph and histogram (or graph 1 and histogram 1) at the same 
time intensifies the graph envelope. 

2. Enabling shade line (or shade line 1) automatically shades graph (or graph 
1); histogram (bit 3) and histogram 1 (bit 4) do not need to be enabled when 
shade lines are used. 
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Table 6-2 Load Enable Register Command (Cont) 
3rd Character (Register 0) 



Bit 

6 

5 
4 



Always 
Always 1 



If 1 , allows graph and 1 data to be shifted from right to left 
{dual strip chart feature) — 



If 1 , allows graph or 1 data to be shifted from right to left 
(single strip chart enabled) — — — — 



If 1, displays graph 1 as a shaded graph, referenced to 
shade line 1 — — — — — — — — — — — — - 



If 1 , displays graph referenced to shade line 



If 0, allows shade line data to be loaded by the second 
word of the @ instruction: if 1 , allows shade line 1 data to 
be loaded by the second word of the @ instruction 



Binary Code 
01 XXX XX 



NOTE Sit 3 enables the single strip chart feature: either graph Q or graph 1 data 
(but not both) can be incremented from right to left. 

Bit 4 enables the dual strip chart feature. With graph enabled, graph data is 
entered, but the data does not shift at this time. Graph 1 is enabled and graph 1 
data is entered, then both graph and graph 1 shift their data one increment to the 
left 
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Function 
Enabled 



Binary Code 
Character Octal Code of Second Decimal 

Sequence* Sequence Character Value 



Graph 
Graph 1 
Graphs and 1 
Histogram 
Histogram 1 
Histograms 

and 1 
Graph and 

histogram 1 
Graph 1 and 

histogram 

Disable graphs 
and histograms 



A# 

A% 

A' 

A) 

A1 

A9 

A3 

A- 

A space 



101 
1 01 
101 
101 
101 
101 



043 
045 
047 
051 
061 
071 



0100011 
0100101 
0100111 
0101001 
0110001 
0111001 



101 


063 


0110011 


101 


055 


0101101 


101 


040 


0100000 



35 
37 
39 
41 
49 
57 

51 

45 

32 



" A third character is used to enable (or disable) shaded graphs (referenced to a 
shade line) and to enable strip charts Refer to Table 6-4. 



Table 6-4 Examples of Selecting Shaded Graphs with Shade Lines 
(Baselines) and Strip Charts 



Function Enabled 

Load shade line 0* 
Load shade line 1* 
Enable shaded graphs 

with shade line and 1 
Enable single strip chart 
Enable strip chart with 

shaded graph and 

shade line 
Dual strip chart 
Dual strip chart with 

shaded graphs and 

shade lines 



Third 


Octal 


Binary 


Decimal 


Character 


Code 


Code 


Value 


» 


042 


0100010 


34 


% 


045 


0100101 


37 


& 


046 


0100110 


38 


( 


050 


0101000 


40 


) 


052 


0101010 


42 





060 


0110000 


48 


6 


066 


0110110 


54 



* Loading or movingthe shade iine(baseiine) in the V M 05 does not affectgraphO 
or graph 1 data Refer to Loading the Shade Line (Baseline) on page 1 76. 



Table 6-5 Graph Drawing Characters 
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Character 



SPACE 



# 

% 
& 

' (apostrophe) 



, (comma) 



\iTiinu3^ 



> 



Octal 






Decimal 


Code 


Binary Code 


Value 


040 


0100 


000 


32 


041 


0100 


001 


33 


042 


0100 


010 


34 


043 


0100 


011 


35 


044 


0100 


100 


36 


045 


0100 


101 


37 


046 


0100 


110 


38 


047 


0100 


111 


39 


050 


0101 


000 


40 


051 


0101 


001 


41 


052 


0101 


010 


42 


053 


0101 


011 


43 


054 


0101 


100 


4b 


Ovjv^ 


0101 


101 


45 


056 


0101 


110 


46 


057 


0101 


111 


47 


060 


0110 


000 


48 


061 


0110 


001 


49 


062 


0110 


010 


50 


063 


0110 


011 


51 


064 


0110 


100 


52 


065 


0110 


101 


53 


066 


0110 


110 


54 


067 


0110 


111 


55 


070 


0111 


000 


56 


071 


0111 


001 


57 


072 


0111 


010 


58 


073 


0111 


011 


59 


074 


0111 


100 


60 


075 


0111 


101 


61 


076 


0111 


110 


62 


077 


WMi&i 


111 


'§ 63 
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Enabling Graphs and Histograms (Shaded Graphs) 

The second chsrscter In b. sequence for load!" rs r, l c? ' , ' o r ^ ooi<*^+c> +h« 
graph or histogram to be displayed. The letter a (101 8 ) allows register 
to be loaded. 

Enabling Strip Charts and Shade Lines (Baselines) 

The third character in the load register sequence enables shaded 
graphs and strip charts. Some of the common functions enabled by the 
third character are listed in Table 6-4. 

Loading Control Register 1 

The characters required to enable graph markers and grid lines are 
formed by setting the appropriate bits in the diagrams in Table 6-6, then 
finding the character for the code created in Table 6-5. 



Table 6-6 Load Enable Register 1 Command 

First character: ' \ I (11 1.3)7310 ' 
Second character: variable (See below) 
Third character: variable (See below) 

2nd Character (Register 1) 



Bit 

6 

5 
4 



Binary Code 
01 XXX XX 



The most significant bit always 
Always 1 



If 1, clears the static RAMs containing any vertical lines 
horizontal lines, graph 0, graph 1 , and any graph markers 
Does not clear the load enable register- Register and 
Register 1 



If 1, allows graph 1 markers to be displayed 
If 1, allows graph markers to be displayed 
If 1, allows vertical lines to be displayed — 



If 1, allows horizontal lines to be displayed 
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Table 6-6 Load Enable Register 1 Command (Cont) 
3rd Character (Register 1 ) 



Bit 

6 Always 



Binary Code 
01 XXXXX 



5 Always 1 
2-4 Unused - 



1 If 1, enable Interactive Graphic Test 

(Not available in VT1 25 emulation) 

If 0, the rectangular graph drawing field is selected; if 1, \ 
the square field is selected \ 

The rectangular field also enabled by an initialize signal I 
(iNiT) during power-up. 



Enabling Graph Markers, Vertical Lines, and Horizontal Lines 

Turning graph markers and grid lines on and off is accomplished by load- 
ing register 1. The character sequence is the same in either graph draw- 
ing format, except a third character establishes the desired format. The 
exclamation mark, !(041 8 ), enables the square format; a SPACE (040 8 ) 
enables the rectangular format. The rectangular format is enabled also on 
initializing the terminal. 

Table 6-7 shows examples of enabling graph markers, horizontal lines, 
and vertical lines. 
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and Vertical Lines 

A/ote: Remember to bit map all options correctly when sending out a command. 
Setting a desired feature may reset other features H 'all options are not considered. 



Function 
Enabled 


Character 
Sequence 


Octal 

Sequence* 
First Second 


Binary Code 
of Second 
Character 


Decimal 
Value 


Clear graph 

drawing 

memories 


10 


111 060 


0110000 


48 


Enable horizontal 
and vertical 
lines 


l# 


111 043 


0100011 


35 


Enable horizontal 
lines only 


I! 


111 041 


0100001 


33 


Enable vertical 
lines only 


1" 


111 042 


0100010 


34 


Enable graph 
markers 


l$ 


111 044 


0101100 


36 


Enable graph 1 
markers 


K 


111 050 


0101000 


40 


Enable graph 
and 1 markers 


l, 


111 054 


0101100 


44 


Enable grid 
and graph 
markers 


r 


111 047 


0100111 


39 


Enable grid 
and graph 1 
markers 


i+ 


111 053 


0101011 


43 


Enable grid 
and graph 
and 1 markers 


1/ 


111 057 


0101111 


47 


Disable lines 
and graph 
markers 


1 space 


111 040 


0100000 


32 



* A third character is required to establish the square format to change formats or 
to set up the interactive Graphics Test 



To load coordinates for the function enabled by register 1 , refer to the following 
paragraphs in this chapter. 



Function 



Paragraph 



Load graph markers Loading Graph Marker Memory 
Load vertical lines Displaying Vertical Lines 
Load horizontal lines Displaying Horizontal Lines 



Page 

180 
181 
182 
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FORMING GRAPH DRAWING DATA CHARACTERS 

In order to represent a horizontal or vertical address of a point on a 240 
X 512 point graph, at least 9 binary bit positions are required. 



Examples: 



239 10 = 01 1 101 1 1 1 2 

51 1 10 = 1111111112 



Keys typed from the keyboard, or transmitted from the host computer, 
normally only contain 7 bits (7-bit ASC1 1 characters). Therefore, two keys 
must be typed, or two codes transmitted, to fully describe an X or a Y val- 
ue. The first key (character) transmits the lower five bits of the binary data 
value: the second key transmits the remaining bits, or upper data value. 



The graph drawing data characters can be standardized to the 32 charac- 
ters listed in Table 6-8 if bits 5 and 6 of each character are always 1 and 



0, respectively, as in the following format: 



n 1 y y v y v 

\j i /\ f\. r\ r\. a\ 



bit 6 

bit 5 

bits 0-4 



The data value is then transmitted in two parts as in the following dia- 
gram. 

Data to be transmitted 



XXXXXXXXX 




1st data character 
2nd data character 



XXXXXXXXX 

Received value 
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Decimal 
Lower Data 
First Data 





1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 



Data Value 
Upper Data 
Second Data 

Load shade 
line (baseline) 
and graph 
data; erase 
other lines. 



32 

64 

96 
128 
160 
192 
224 
256 
288 
320 
352 
384 
416 
448 
480 

Load Horizontal, 
vertical lines, 
and markers* 



Binary 
Code 



Octal 
Code 



Data 
Character 



0100000 
0100001 
0100010 
0100011 
0100100 
0100101 
0100110 
0100111 
0101000 
0101001 
0101010 
0101011 
0101100 
0101101 
0101110 
0101111 



040 
041 
042 
043 
044 
045 
046 
047 
050 
051 
052 
053 
054 
055 
056 
057 



SPACE 



& 

'(apostrophe) 
(' 

) 
* 

+ 

, (comma) 
— (minus) 
. (period) 

/ 



16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 





32 

64 

96 

128 

160 

192 

224 

256 

288 

320 

352 



0110000 
0110001 
0110010 
0110011 
0110100 
0110101 
0110110 
0110111 
0111000 
0111001 
0111010 
0111011 



060 
061 
062 
063 
064 
065 
066 
067 
070 
071 
072 
073 



29 
30 
31 



416 
448 
480 



0111101 
0111110 
0111111 



075 
076 
077 



i Upper data values below this line are used for loading graph markers and 
horizontal or vertical lines; they require bit 4=1 . To erase these lines, or load 
shade lines (baselines), graph data or starting X-coordinate, use values above 
this line. 
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Selecting Upper and Lower Data Characters 

The value of the lower data ranges from to 31 ^ the upper data value 
increases in increments of 32 decimal units. Together they can describe 
any value of the graph drawing field. To find the characters or code to 
transmit a desired location, perform the following. 

1. Select the upper data value closest, but not exceeding, the desired 
value in Table 6-8. This is the second data character which is trans- 
mitted last. 

Example 



Value 
To be 



Nearest 

Upper 

Data 



Transmitted Value 



Second 

Data Binary Octal 

Character Code Code 



nr\r\ 



HOI _ 

'^10 



n-tnrn in. 

V 1 WW I 1 w^ 



NOTE: If a horizontal line, vertical line, or graph marker is to be 
loaded, use values in the lower half of the upper data column; i.e., 
192^o is 066q or the character 6. 

Find the remainder of the value to be transmitted in the lower data 
value column. This will be the first data character transmitted. 

Example 





Lower 


First 






Remaining 


Data 


Data 


Binary 


Octal 


Value 


Value 


Character 


Code 


Code 



8 



8 



( 



0101000 2 050 8 



Load Data Sequences 

The data to be transmitted is initially preceded by a "load character," as 
described in Table 6-9. In the above example, loading a shade line at line 
200^ is transmitted by @(& or equivalent program. Storing a horizontal 
line at line 200^ is transmitted by D(6 or equivalent program. 



For multiple data entries, the load character does not need to be repeat- 
ed. This allows data for a graph to be loaded into memory without repeat- 
ing the character B or J. Exceptions to this procedure are loading a shade 
line and loading the starting X-coordinate. 
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Function 

Load shade line (baseline) 
Load graph data 
Load graph 1 data 
Load graph marker 
Load graph 1 marker 
Load horizontal line 
Load vertical line 
Load starting x-coordinate 



Load 


Character 




Character 


Sequence 


Range 


@ 


@ 1st data 2nd data 


0-239 


B 


B 1st data 2nd data 


0-239 


J 


J 1st data 2nd data 


0-239 


C 


G 1st data 2nd data 


0-511 


K 


K 1st data 2nd data 


0-511 


D 


D 1st data 2nd data •; 


0-239 


L 


L 1st data 2nd data 


0-511 


H 


H 1st data 2nd data 


0-511 



Frequent Data Entry Errors 

Largest Data Character Transmitted First - The low-order bits of the 
data value (lower data value in Table 6-8) must be transmitted first. If re- 
versed, the point will typically exceed the range limits of the graph draw- 
ing field and not be displayed, or, it may appear near the edge of the field. 

Example 



Desired 


Data 


Correct 


Characters 


New 


Shade line 


Transmitted 


Characters 


Reversed 


Values 


40 


8 + 32 


@(! 


@K 


1+256 


70 


6 + 64 


@&" 


@"& 


2+192 



Zero Valued Characters Not Transmitted - When transmitting data with 
two characters, if the upper data value is equal to the point or line de- 
sired, a SPACE (040s) (equal to zero) must be the first data character. If 
missed, the line or point will be much less than desired. 

Example 



Shade Line 


Data 


Correct 


Characters 


Wrong 


Desired 


Required 


Characters 


in Error 


Value 


160 


+ 160 


@ SPACE % 


@°/o 


5 



LOADING SHADE LINE (BASELINE) 

A moveable shade line can be displayed for both graph and graph 1. 
One shade line can be entered for graph 0, and one for graph 1, on any of 
the 230 (or 240, square format) horizontal lines available. To transmit po- 
sitions within this range, a load character and two data characters are 
used (Table 6-10). Create positions by following the information in Form- 
ing Graph Drawing Data Characters on page 173. 
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Previous 




VT55 Format 


First character 


@ NOP 


Second character 


none 


Third character 


none 



Table 6-10 Loading Shade Line Position 

New VT105 Format 
Load Shade Line 

@(100 8 )64 10 
01 XXXXX 
01XXXXX 

NOTE Shade line or shade Uriel is loaded depending on which shade line is 
selected by loading register 0. Refer to Enabling Strip Charts and Shade Lines 
(Baselines) on page 170. 



LOADING GRAPH MEMORIES 

The M7071 has two graph memories - graph and graph 1. Each graph 
may njot up to 51 2-horizonta! n oints. Each horizontal point may have only 
one value using up to 230 vertical points with the rectangular format (or 

r» Ar\ _x: i __:_x_ ...:il il. __..__-. x__~.«x\ tu» ~-,*„u u~„:~~ ~^4.~..:.~,-. 

^h-u vei noai (juiiiis wini mc sijuciic luinim/. inc yiapu ucyiuo ciiiciiny 

data at X = (040s) unless a starting X-address is specified. Refer to 
Load Starting X-Coordinate on page 183. 

The data to be entered is initially preceded by the letter B (102 8 ) for graph 
0, or J (1 12s) for graph 1. Each pair of data characters describes a Y-data 
point. 

A Y-value is entered for each value of X, using two data characters (as 
described in Forming Graph Drawing Data Characters on page 173). As 
the X-address is incremented from to 51 1, the values of Y can sequen- 
tially be loaded into memory. The X-register automatically increments af- 
ter each pair of Y-data characters are stored in memory, except when 
dual strip charts are enabled. (Refer to Entering Strip Chart Data on page 
185.) The letters B or J do not need to be repeated for each pair of Y-data 
characters. Table 6-8 may be used to determine the Y-data characters. 

NOTE: For each value of Y, the lower data value must be transmitted 
first, then the upper data value. 

Table 6-1 1 describes the formation of graph data characters. 
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Table 6-1 1 Loading Graph Data 

Graph 

First character: B (102 8 ) 

Second character: variable (see below) I 

Third character: variable (see below) 

Explanation of Second Character. 



Bit 



Graph 1 

J(1t2 8 ) 
variable 
variable 



Binary Code 

01XXXXX 



6 The most significant bit always 
5 Always 1 — — — — — — — - 



0-4 The remaining bits form the low-order 5 bits of an 8-bit 
Y-value. 

Explanation of Third Character 



Binary Code 
01 XXXXX 



Bit 

6 

5 
4 
3 



The most significant bit always 

Always 1 

Unused 

Unused 



0-2 The remaining bits form the high-order 3 bits of the 8-bit 
Y-valua 



HISTOGRAM DATA 

Data for a histogram (shaded graph) is entered by loading the appropriate 
graph memory (refer to Loading Graph Memories on page 177). Histo- 
gram and /or Histogram 1 is enabled by loading register 1 (refer to Se- 
lecting Desired Display on page 164). Enabling a histogram shades points 
between the graph envelope and the bottom of the graph field. Shading 
occurs from the graph data to graph line (Figure 6-7). With a shade line 
(baseline) enabled, the graph is shaded above and below this line (Figure 
6-8). 
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MR -35 16 

MA-9454 



Figure 6-7 Histogram without Shade Line (Baseline) Enabled 




MR-3517 
MA-9455 



Figure 6-8 Graph with Shade Line (Baseline) Enabled 
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LOADING GRAPH MARKER MEMORY 

A graph marker is a short vertical iine marks the graph iine at a desired 
value of X. A graph marker can be programmed for any point on graph 
and on graph 1. As many as 512 graph markers can be placed on each 
graph. 

Loading graph marker memory is accomplished by sending pairs of data 
characters following the letter C (103 8 ) for graph 0, or K (1 13 8 ) for graph 
1. Each pair of data characters represents the lower data value and the 
upper data value of an X-address, (Table 6-12). Note that bit 4 of the third 
character determines whether the graph marker will be loaded or erased. 

Example 





Binary 


Octal 


Character 


Function 


Code 


Code 


Sequence 


Load graph marker 


1000110 


106 




at location 100 


0100100 


044 


C$3 




0110011 


063 




Erase graph 


1000110 


106 




marker at location 100 


0100100 


044 


C$# 




0100011 


043 





Table 6-8 may be used to determine the characters required to load or 
erase a specific graph marker. Once stored in memory, graph markers 
are enabled and disabled by loading register 1. (Refer to Loading Control 
Register 1 on page 170.) 
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Table 6-12 Load Graph Marker Memory 



First character 
Second character 
Third character 



Graph 
Marker 

C(103 8 ) 

variable 

variable 



Graph 1 
Marker 

K(113 8 ) 

variable 

variable 



Explanation of Second Character 



Binary Code 
01 XXXXX 



Bit 

6 

5 



The most significant bit always 
Always 1 — — — — — — 



0-4 i be remaining otts Torm the tow-oraer o oits or a y-ort 
X-address. 

Explanation of Third Character: 



Binary Code 
01 XXXXX 



Bit 

6 The most significant bit always — — 

5 Always 1 — — — 

4 If 1 , causes graph marker to be loaded; 
if 0, causes marker to be erased 



0-3 The remaining bits form the high-order 4 bits of the 9-bit 
X-address. 



DISPLAYING VERTICAL LINES 

Vertical lines may be programmed for any of the 512 points along the X- 
axis. Vertical lines are loaded following the letter L (114 8 ). The second 
and third characters form an X-data value (Table 6-13). Note that bit 4 of 
the third character must equal a 1 for the line to be loaded; a in bit 4 
erases that line. Table 6-8 may be used to determine the characters re- 
quired to load or erase a specific line. Vertical lines are enabled and dis- 
abled by loading register 1. (Refer to Loading Control Register 1 on page 
170.) 
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First character: L(114 Q ) 

Second character: variable (see below) 

Third character: variable (see below) 

Explanation of Second Character: 



Binary Code 
01 XXXXX 



Bit 

6 



The most significant bit always 
Always 1 



0-4 The remaining bits form the low-order 5 bits of an 9-bit 
X-position. 

Explanation of ^ Third Ghaiistcter: 



Bit 

6 



Binary Code 
01 XXXXX 



The most significant bit always -^- 

5 Always 1 

4 If 1 , causes vertical line to be loaded; 
if 0, causes vertical line to be erased 



0-3 The remaining bits form the high-order 4 bits of a 9-bit 
X-position. 



DISPLAYING HORIZONTAL LINES 

A horizontal line is loaded into memory by two data characters following 
the letter d (104 8 ). The second and third characters form a Y-data value 
(Table 6-14). Up to 230 horizontal lines may be displayed in the rectangu- 
lar format; 240, in the square format. Note that bit 4 in the third character 
must equal a 1 to load a horizontal line; bit 4 = erases the line. Table 6-8 
can be used to determine the characters required to load or erase a spe- 
cific horizontal line. Horizontal lines are enabled and disabled by loading 
register 1. (Refer to Loading Control Register 1 on page 170.) 
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Table 6-14 Load Horizontal Line Coordinates 

First character: DCIO43) 

Second character: variable (see below) 

Third character: variable (see below) 

Explanation of Second Character 



Binary Code 
01 XXXXX 



Bit 

6 



The most significant bit always 
Always 1 



0-4 The remaining bits form the low-order 5 bits of an 8-bit 
Y-position. 

Explanation of Third Character: 



Binary Code 
01 XXXXX 



Bit 



The most significant bit always 



Ai\A/a\/<% 



If 1 , causes horizontal line to be loaded; 
if 0, causes horizontal line to be erased 



Unused 



0-2 The remaining bits form the 3 high-order bits of an 8-bit 
Y-position. 



LOAD STARTING X-COORDINATE 

A starting X-coordinate may be loaded by two data characters following 
the letter H (110 8 ) (Table 6-15). Any value of X, from to 511, may be 
used. The data characters required for the desired X starting address can 
be determined from Table 6-8. 



NOTE: The lower data value of X must be transmitted first, then the up- 
per data value. 
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i aDie o- 1 o i_oaa aiamng a Coordinate 

Rrst character: H (1 1 0g) 

Second character: variable (see below) 

Third character: variable (see below) 

Explanation of Second Character 



Bit 

6 The most significant bit always 

5 Always 1 



Binary Code 
01 XXXXX 



0-4 The remaining bits form the low-order 5 bits of a 9-bit 
X- position. 

Explanation of Third Character 



Bit 



Binary Code 
01 XXXXX 



6 The most significant bit always 

5 Always 1 

4 Unused 



0-3 The remaining bits form the high-order 4 bits of a 9-bit 
X- position. 
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ENTERING STRIP CHART DATA 

Single Strip Chart Data 

Data for a single strip chart is entered by loading either graph or graph 1 
memory. 

1. Enable the desired graph and single strip chart feature by loading 
register (Table 6-2). 

Example 

Enable graph 0, single strip chart, and shade line 0. Enter the follow- 
ing. 

Character Octal Decimal 

Sequence Sequence Sequence 



A +*■ * 


-irn r\A o r\crt 


£>e oc Art 


/-ITT- 


iu ig utog \j<jcq 


vv>10 *J*->10 ***-10 



2. If desirable, load the starting X-coordinate at the right margin. Enter 
the following. 

H?? 110 8 077 8 077 8 72 10 63 10 63 10 

3. Enter data into graph memory; type B plus any sequence of two 
data characters. If started at the right margin, this causes the graph 
to move from right to left; if not, the graph fills the screen first, then 
moves data from right to left with each new data word. 

B(data)(data) 102 8 (data)(data) 66 10 (data)(data) 

Dual Strip Chart Data 

Perform the following procedure to set up the dual strip chart feature. 

1. Enable both graphs and the dual strip chart feature. Set bit 4 of the 
third character in register 0. (Refer to Table 6-2.) 

Example 

Load graph and 1, dual strip chart, and shade line and 1. Enter 
the following. 

Character Octal Decimal 

Sequence Sequence Sequence 

A '6 101 8 047 8 066 8 65 10 39 10 54 10 

H?? 110 8 077 8 077 8 72 10 63 10 63 10 
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2. Enter graph data; enter a B and two data characters. (The data is 

v^'iiit/i Ou, OCit iiit; ^i upn OOv^o i iOi iiivvg ui li iio iiiiio./ 

B(data)(data) 102 8 (data)(data) 66 10 (data)(data) 

3. Enter graph 1 data; enter a J plus two data characters. The graph 
now displays and shifts both graph and graph 1 data points one 
increment to the left. 

J(data)Cdata) 1 12 8 (data)(data) 74 10 (data)(data) 

NOTES 

1. Load starting X-coordinate, desired graph markers, and vertical lines 
before enabling either single- or dual-strip chart mode. The exact posi- 
tion of these points may vary once a strip chart is enabled. 

2. Any graph markers and vertical lines enabled wrap around as the strip 
chart moves. 

3. When the strip chart mode is disabled, any displayed graphics shifts. 
The X-coordinate that moved during strip chart mode returns to its 
normal location. 

4. When in dual-strip chart mode, the last available graph position 
(X=511) is not displayed. The switching action between graph and 
graph 1 in that position is eliminated from the display. 
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GENERAL 

This chapter describes how the VT125 terminal communicates with a 
computer using the standard EIA interface. Also included are descriptions 
of communication features, a definition of the Break signal, a description 
of communication of the graphics processor with the rest of the terminal 
and its options, and methods used to prevent input buffer overflows of the 
terminal. 

NOTE: The 20 mA current loop interface option (VT1XX-CA) is described 
in Options (Chapter 10). 



COMPUTER 




CONNECTING TO COMPUTER PORT 

The VT125 terminal is connected to a computer directly or through a com- 
mon carrier facility (telephone line) as shown in Figure 7-1. In both appli- 
cations, either the Electronic Industry Association (EIA) interface provid- 
ed with the terminal or the VT1XX-CA 20 mA Current Loop interface option 
are used. Table 7-1 lists the computer port EIA connector signals. 



COMPUTER 



I 



VT125 TERMINAL 




VT125 TERMINAL 




Figure 7- 1 Connecting to the Computer 
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IdUm l-\ 



i^umpuier run cim oonneuior signals 



Pin Name 

1 Protective 
ground 



Transmitted 
data 



Mnemonic 



PGND 



CCITT/EIA 
Designation 

101/AA 



TXD 



103/BA 



Description 

This conductor is con- 
nected to the VT1 25 chas- 
sis and to external ground 
through the third wire of 
the ac power cord. 

From VT1 25 

The VT1 25 transmits serial 
characters and Break sig- 
nals on this circuit. This 
conductor is in the mark 
state when no characters 
or Break signals are being 
transmitted. 



3 Received RXD 

data 



\-:' E; : : iS-tdsend:^:S^\ :; ;^:-:-- 



104/ BB To VT1 25 

^^ : -C-"M---W' ■"computer,:, ■?; : :{: /: -v : ^:j.v- ■;- 

■ t05/CA ; ; -W; 'frofriMl 25 H ■;::■;; 



signals except protective 

:; l| ! l||SillIlS?5ll|ISll: : l:|||li 



20 Data DTR 

terminal 
ready 



: fyyuM'^^ 

::;:■ ■^/■•^itions ;;e$sfc::::;;- r 
MkMMyyy-'\+:VT J \25 is not on 
. VT1 25 is LOCAL 

• During a reset or test 

• 3.5 seconds during a 



2 Speed SPDSEL 111/CH FromVT125 

select Also called Secondary 

Request to Send this sig- 
nal is on whenever the 
VT1 25 is on. 
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When connecting the terminal to the computer through a telephone line, a 
modem or acoustic coupler is needed. The modem or acoustic coupler 
changes the serial characters transmitted between terminal and computer 
into signals that can be transmitted over the telephone line. Several types 
of modems can be used with the VT125 terminal. However, the modem 
used by the terminal must be compatible with the modem used by the 
computer. 

CONNECTING TO AUXILIARY PORT 

The auxiliary port connects a graphics or text printer to the VT125. It is 
bidirectional so it can also be used for input to the computer. The appli- 
cation program on the computer must use the media copy commands 
(Chapter 4) to use the auxiliary port. 

SERIAL CHARACTER FORMAT 

The VT125 terminal communicates using serial characters. Serial charac- 
ters are transmitted using a start bit, 7 or 8 data bits, an optional parity 

Ki* «ar»H nrto r\r t\*/r> c+r»n hitc Finnro 7-9 chnuue an PYflmnlp nf the* QPrinl 

character format used by the terminal. 

The number of data bits per character and parity are selected using the 
parity sense, parity, and bits per character SET-UP B features. If 8-bit 
characters are selected, the last data bit is forced to the Space (0) condi- 
tion and the eighth data bit is ignored when receiving characters. The 
data bits are transmitted with the least significant bit first. (Refer to ANSI 
X3. 15- 1976 for details on the serial character format.) 

The parity bit is used to detect character transmission errors of both 
transmitted and received characters. The parity sense SET-UP B feature 
selects the type of parity bit used when transmitting and receiving charac- 
ters. 

The parity SET-UP B feature determines if the parity of received charac- 
ters is checked or ignored. If the parity SET-UP B feature is off, the parity 
bit is removed from the serial character. 

The number of stop bits (1 or 2) in the serial character is determined by 
the transmit and receive speed SET-UP B features. 




70R 8 
DATA BITS 



01 | 02 I 03 | 04 | 05 | 06 | 



07 
MSB 



START BIT OF 
NEW CHARACTER 



1 OR 2 

BITS 



STOP. STOP 
1 , 2 



ONE BIT 

TIME = 

ONE/ 

BAUD RATE 



"\ 



WHEN OPTIONAL RETUR 
8-BIT PARITY STATE 

CHARACTERS BIT 
ARE USED 
8 th BIT=0 



NTO IDLE 
OF LINE 



Figure 7-2 Serial Character Format 
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BREAK SIGNAL 

#-v ui tai\ oivjiicii Octii ijti 11 ai 101 1 iiucvj uy n ic ici 



ic ui cai\ oiyi 



transmitted space condition for 0.275 seconds ±10 percent. However, 
the computer response to the Break signal depends on the computer and 
software used. A long break disconnect is a transmitted space condition 
for 3.5 seconds ± 10 percent and then the Data Terminal Ready interface 
signal is turned off. 

NOTE: On some modems, the long break disconnect causes the modem 
to perform a communication line disconnect. 

FULL-DUPLEX COMMUNICATION 

The VT125 terminal operates in full-duplex communication. Full-duplex 
communication means that the terminal transmits and receives charac- 
ters at the same time. The VT125 provides some EIA signals (Table 7-1). 

ELECTRONIC INDUSTRY ASSOCIATION (EIA) INTERFACE 

The VT125 communication interfaces are DB-25 (EIA RS-232-C type) male 
connectors mounted on the back of the terminal (Figure 7-3). These con- 
nectors meet EIA standards RS-232-C and CCITT V.24 and V.28. When 
connecting to a device that meets EIA standard RS-232-C, the terminal 
can operate at speeds up to 19200 baud using communication cables up 
to 15 meters (50 feet) in length. Table 7-1 describes the EIA connector pin 
signals used by the computer port. Table 7-2 describes the EIA connector 
pin signals used by the auxiliary port. All connector pins not described are 
not used by the terminal. Figure 7-3 shows the connector pin arrange- 
ment. 




25 PIN MALE CONNECTOR 



AUXILIARY 
PORT 




25 PIN MALE CONNECTOR 



Figure 7-3 EiA Connectors and Pin Locations 
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Table 7-2 Auxiliary Port EIA Connector Signals 



Pin 


Name 


Mnemonic 


CCITT/EIA 
Designation 


Description 


1 


Protective 
ground 


PGND 


101/AA 


This conduct 
nectedtothe 



Transmitted 
data 



TXD 



sis and to external ground 
through the third wire of 
the ac power cord. 

103/BA FromVT125 

The VT1 25 transmits serial 
characters and Break sig- 
nals on this circuit. This 
conductor Is in the mark 
state when no characters 
or Break signals are being 
transmitted. 



3 Received RXD 

data 



6 Data 
set 
ready 



DSR 



104/BB T0VTI25 

This conductor receives 
serial characters from the 
auxiliary port 

107/CC ToVT125 

The terminal receives data 
terminal ready (DTR) from 
the printer on this conduc- 
tor. If DSR is present at 
power- up, the printer 
controls print operations 
If DSR is not present at 
power-up, then before 
each characterprint oper- 
ation, the terminal checks 
again. If DSR is stilt not 
present, the print occurs 
If DSR ever appears then 
it controls all following 
prints The terminal also 
uses DSR to detect the 
printer for the Device 
Attributes response 
(Chapter 4). 



7 Signal SGND 102/AB This conductor is the corn- 

ground mon ground reference 

potential for all connector 
signals except protective 
ground. Also, it is 
connected to the VT1 25 
chassis. 



20 



Data 

terminal 

ready 



DTR 



108.2/CD FromVT125 

This signal is always on 
when the terminal is on. 



192 COMMUNICATIONS 



SET-UP AND COMMUNICATIONS 

When you exit SET-UP, the terminal: 

1. Updates all aspects of its operation according to any new SET-UP 
feature selections. 

2. Sends XON to the computer port and auxiliary port if buffer space is 
available. 

3. Clears any received XOFF to allow transmission on all ports. 

4. Cancels any ReGIS hardcopy operation. 

NOTE: Some graphic printers have large input buffers. A cancelled 
hardcopy operation may not stop for several seconds while the print- 
er empties its buffer. 

CONTROL FUNCTIONS 

The graphics processor is the control point for all communication in the 
VT125. (Refer to Figure 7-5.) The graphics processor examines any ANSI 
control function arriving from any of the communication ports. If the graph- 
ics processor has a response for the control function, it acts on the con- 
trol function and generally does not pass it on. If the graphics processor 
does not have a response for the control function, it ignores the control 
function and passes it on. The device at the receiving end of the data 
path that the control function arrived on receives the passed control func- 
tion. 

From the keyboard, however, a special condition applies. The escape 
character (ESC) has many software applications and must be allowed to 
pass to the application program. The following process decides when to 
pass ESC. 

1. ESC is held in the graphics processor for a maximum of 50 millise- 
conds. 

2. If another character arrives within 50 milliseconds: 

a. Both characters are accepted by the graphics processor as part of 
a control function, or 

b. Both characters are passed immediately if the control function 
does not apply to the graphics processor. 

3. If no character arrives within 50 milliseconds, the ESC is passed. 

A common delay between characters for a typist is 50 milliseconds. Inter- 
nal communications between the graphics processor and the VT100 text 
terminal operate with less than 20 ms delay between characters. The 
graphics processor does not have responses to the control functions 
transmitted by the special keys on the keyboard, so they are always 
passed through. 
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COMMUNICATION CABLES 

Communications cables for both the EIA and 20 mA current loop inter- 
faces of the terminal can be ordered from the DIGITAL Accessories and 
Supplies Group. Part numbers and ordering information for these cables is 
supplied in Chapter 11. Table 7-3 describes each communication cable 
used and Figure 7-4 shows connection examples for each cable. 



Table 7-3 Interface Cables 
Number Length 



BC05F-xx 



Variable 



Connector Types 



BC22A-10 


3 meters 
(10 ft) 


RS-232 (female) 
to RS-232 (female) 


BC22A-25 


7.6 meters 
(25 ft) 


RS-232 (female) 
to RS-232 (female) 


BC22B-10 


3 meters 
(10 ft) 


RS-232 (male) 
to RS-232 (female) 


BC22B-25 


7.6 meters 
(25 ft) 


RS-232 (male) 

to RS-232 (female) 


BC03M-xx 


Variable 


RS-232 (female) 
to RS-232 (female) 


BC05D-xx 


Variable 


RS-232 (male) 

to RS-232 (female) 



Mate-N-Lok" (male) 
Mate-N-Lok(male) 



Function 

Null modem; direct connection 
between VT1 25 and computer or 
printer (6-conductor cable) 

Null modem; direct connection 

U ~. -I. ..*_.** « \fH OCT A ~%*J a^m^^ii+a*. r*w 

UCIWCCM V I I CO CUIU OUIII(JUlCI V-»l 

printer (6-conductor cable) 

Extension; connects VT1 25 to a 
modem (1 4-conductor cable) 

Extension; connects VT1 25 to a 
modem (1 4-conductor cable) 

Null modem; direct connection 
between VT1 25 and computer or 
printer 

Extension; connects VT1 25 to 
a modem 

20 mA; direct to connection between 
VT125 with a 20 mA option installed 
and a computer 
(Supplied with 20 mA option) 



BC05X-xx 



30-10958-02 



Variable 



EIA 450 mm 
(18 in) 

20 mA 2.4 meters 
(8 ft) 



Mate-N-Lok (male) 
to Mate-N-Lok(male) 

RS-232 (male) 
to RS-232 (female) 
and 20 mA (male) 



20 mA extension cable 



Connection between DF01 -A 
acoustic coupler and VT1 25 EIA 
or 20 mA 



AMP, Inc. 
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COMMUNICATION 

(MODEM) 

CONNECTOR 



NULL MODEM CABLE BC 22A 
BC03M 




COMMUNICATION 

(MODEM) 

CONNECTOR 



EXTENSION CABLE BC22B 
BC05D 



COMMUNICATION 

(MODEM) 

CONNECTOR 



m 




30-10958-02 




IM 

20 mA 



20mA 
CONNECTOR 



20MA EXTENSION 
CABLE BC05X 



COMPUTER 



F M 



L 

r 



MOD EM/ DATA SET 



r 






DF01-A ACOUSTIC COUPLER 



COMPUTER 



M F 



L 



Figure 7-4 Cable Summary 

BLOCK DIAGRAMS 

The VT125 is a complex device that has several separate processes op- 
erating at the same time to provide graphics and text over a simple termi- 
nal communication line. Figure 7-5 shows a general block diagram of the 
VT125. This shows two main functional blocks: the graphics processor 
and the VT100 text terminal that holds the graphics processor. The figure 
shows two important facts. 

1. The keyboard communicates only with the VT100, so that LOCAL op- 
eration can only cause actions in the VT100, not in the graphics pro- 
cessor. 



2. The graphics processor manages all communications between the 
computer and the VT100, and always uses XON/XOFF. (This SET- 
UP feature cannot be turned off.) 
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Figure 7-5 VT 1 25 General Block Diagram 



Figure 7-6 is a more detailed look at the communication structure in the 
graphics processor itself. This shows the buffers that are included for 
each of the three bidirectional communication ports in the graphics pro- 
cessor. The dispatcher is many processes. It controls the buffers with 
XON/XOFF. It sets up the data paths from each sending port to each re- 
ceiving port. And it parses all communications according to ANSI X3.64- 
1979. That is, it examines data from all ports for instructions to itself. It 
passes anything that does not apply to the graphics processor to which- 
ever ports are set to receive the data from that source. Among the ports 
controlled by the dispatcher are the selection of the graphics protocol un- 
der ANSI sequence control. The choices in that block of the diagram are 
ReGIS, VT105 emulation, and DECwriter graphics. The following five fig- 
ures show the internal connections that are set up for different appli- 
cations. 



Figure 7-7 shows the VT125 operating as a text-only terminal. This is how 
the terminal operates when it is first powered up. If you send XOFF from 
the keyboard, either by pressing NO SCROLL (if AUTO XON/XOFF is on) 
or by pressing S while pressing CTRL, the receive buffer in the VT100 fills 
to the 32 character mark. Then the VT100 sends XOFF to the graphics 
processor. When the 16 character transmit buffer in the graphics proces- 
sor fills, it sends XOFF to the dispatcher, and then the 128 character re- 
ceive buffer fills to its 48 character mark. At that point (80 characters lat- 
er) the graphics processor sends XOFF to the computer. 
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Figure 7-6 VT 125 Data Paths 
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Figure 7-7 VT125 as Text-Only Terminal 
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Figure 7-8 shows the VT125 operating as a graphics terminal. A device 
control string is being sent to the terminal from the computer. The terminal 
may be in any protocol: ReGIS, VT105, or DECwriter graphics. The key- 
board can communicate with the computer, but any screen response to 
keyboard commands is under the control of the computer's programming. 

Figure 7-9 shows the VT125 operating as a graphics terminal. A device 
control string is being sent to the terminal from the computer. The graph- 
ics protocol commands are being displayed on the screen at the same 
time. This is a feature of VT125 ReGIS and is not available with the other 
protocols. The keyboard can communicate with the computer, but any 
screen response to keyboard commands is under the control of the com- 
puter's program. 

Figure 7-10 shows the VT125 printing from the screen to the optional 
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screen hardcopy command in ReGIS. The keyboard can communicate 
with the computer, but the computer cannot communicate with the dis- 
patcher until the print operation is complete. However, if a graphics off 
command (string terminator: ESC \) immediately follows the hardcopy 
command, the computer can communicate with the dispatcher during the 
print operation. 

Figure 7-11 shows the VT125 printing from the computer to the optional 
printer. This is the result of the ANS! media copy command from the com- 
puter. The media copy command can turn the VT100 and auxiliary (print- 
er) ports on and off. Therefore, the screen could display the data that is 
going to the printer if wanted. To print a stored DECwriter graphics pro- 
tocol file, display it on the screen and then use the ReGIS hardcopy com- 
mand to print it. 
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Figure 7-8 VT125 in a Graphics Protocol 
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Figure 7-9 VT125 in ReGIS Graphics with Commands on Screen 
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Figure 7-10 VT125 Printing from Screen 
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Figure 7-11 VT 1 25 Printing from Computer 

INPUT BUFFER OVERFLOW PREVENTION 

When the terminal receives a character (other than the NUL and DEL 
characters), the character is piaced in a 128-character input buffer. The 
input buffer holds the received character until the dispatcher processes 
the character. When processed, the character is removed from the input 
buffer. 



If received characters are placed in the input buffer faster than the char- 
acters are processed, the input buffer begins to fill with characters. If the 
input buffer becomes full, all new characters received are lost and the 
substitute character (&") is displayed. 

Using XON and XOFF characters between the terminal and the devices it 
communicates with prevents input buffer overflow. The graphics proces- 
sor always has an automatic XON/XOFF protocol in operation. The many 
different operations that the processor can perform, from graphics pro- 
tocols to local printing, take widely different amounts of time to perform. 
The techniques of fill characters and low speed operation (that are sug- 
gested as alternate methods of buffer overflow prevention for the VT100 
text terminal) cannot be used with the VT125 graphics terminal. 

XON and XOFF Control Characters 

The XON and XOFF control cha/acters indicate the number of characters 
in an input buffer. When the 128 Jcharacter input buffer of the graphics pro- 
cessor holds 48 characters, the graphics processor transmits XOFF 
(DC3, octal 023). The computer or other device should stop transmitting 
characters. 
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As the dispatcher removes characters from the input buffer, the number of 
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acters, the graphics processor transmits XON (DC1, octal 021) request- 
ing the computer to continue transmission. 

If the computer fails to respond to the XOFF character transmitted by the 
graphics processor, the input buffer continues to fill. The graphics proces- 
sor transmits a second XOFF when the input buffer holds 1 12 characters. 
This second XOFF is a last request to the computer to stop transmitting 
characters before overflow. Then, an overflow at 128 characters transmits 
a final XOFF. 

To determine how fast the computer must respond to the first XOFF char- 
acter to avoid input buffer overflow, use the following formulas. 

Number of characters to overflow = 80 — [3 X (receiver speed /transmit 
speed)] 

Time to respond to XOFF = Number of characters to overflow x (bits per 
character + parity bit + number of stop bits + 1)/receiver speed. 

Example 1 

The graphics processor transmits and receives 8-bit characters with no 
parity at 1200 baud. When the graphics processor transmits the first 
XOFF, the computer stops transmitting within 0.642 seconds or the input 
buffer overflows. 

Number of characters to overflow = 80 — [3 X 1200/1200)] = 77 char- 
acters 

Time to respond to XOFF = 77 X (8 + 0+ 1 + 1)/ 1200 = 0.642 second 

Example 2 

The graphics processor is transmitting and receiving 7-bit characters with 
parity at 300 baud. When the graphics processor transmits the first XOFF, 
the computer stops transmitting within 2.57 seconds or the input buffer 
overflows. 

Number of characters to overflow = 80 — [3 X 300/300] = 77 charac- 
ters 

Time to respond to XOFF = 77 X (7+ 1 + 1 + 1)/300 = 2.57 seconds 

NOTE: If the input buffer overflows, received characters are ignored and 
the substitute character ( $ ) is displayed. 
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EFFECTS OF RESET AND TESTS 

Two control sequences, reset and invoke confidence test, initialize the 
terminal and erase all buffers. This means that characters received while 
these two functions are processed are lost. Therefore, immediately after 
sending the reset or invoke confidence test sequences, the computer 
should assume that it received an XOFF from the terminal. The computer 
should then send no more characters until it receives XON. The terminal 
transmits XON only after it completes the test. 

NOTE: The reset and invoke confidence test sequences may cause the 
terminal to disconnect from the communication line. 

TRANSMIT BUFFERS 

The transmit buffers hold characters generated by the terminal before 
they are transmitted to the computer. The computer can use the XON 
(DC1, octal 021) and XOFF (DCS, octal 023) characters to control the 
transmission of characters from the terminal. 
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acters except XOFF and XON. When the 16-character transmit buffer fills, 
the dispatcher stops accepting characters from the receive buffer of the 
port that is transmitting (for example, the VT100). When the receive buffer 
fills with 48 characters, it sends XOFF to its sender (in this example, the 
VT100). It transmits a second XOFF if the buffer fills to 112 characters. 
From seven to nine characters are stored in the VT100 keyboard buffer. 
(Some keys transmit three characters at once. The buffer locks at 7 char- 
acters to prevent loss of the added characters of a 3 character key 
stroke.) If the keyboard buffer fills, the KBD LOCKED indicator turns on 
and keyclicks stop (if the keyclick SET-UP B feature is on). 

Receipt of XON starts the transmission of characters again. The 16-char- 
acter transmit buffer empties and the dispatcher moves characters from 
the receive buffer to the transmit buffer. When the receive buffer empties 
to the 16-character level, it sends XON to the transmit buffer in the VT100. 
(Also, entering and exiting SET-UP turns off the KBD LOCKED indicator 
and allows the VT100 to transmit characters. However, characters trans- 
mitted after entering and exiting SET-UP may be lost if the receive buffer 
is not ready to receive characters.) When the keyboard buffer empties, 
the KBD LOCKED indicator turns off and keyclicks occur when keys are 
pressed (if the keyclick feature is on). 
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GENERAL 

This chapter describes how to install the VT125 terminal. The installation 
procedure describes how to select the proper input voltage selection and 
fuse for either 120 or 220 - 240 Vac operation. The power up and check- 
out procedure provides a step-by-step procedure for powering up the 
VT125 terminal. 

SITE CONSIDERATIONS 

The VT125 terminal is made up of a video monitor and a detachable key- 
board. (Dimensions are shown in Figure 8-1). Table 8-1 lists the environ- 
mental and power specifications of the terminal. If the terminal will be 
used with a color video monitor, get four video cables that are long 
enough for your location. 

NOTE: When installing the terminal, make sure that all power and signal 
cables are free from any stress, sharp bends, or obstructions. Also, be 
sure to provide access to the power switch on the back of the terminal. 

Do not block air flow around the terminal. There are several ventilation 
openings to prevent the terminal from overheating. Do not block these 
openings by placing objects on top or under the terminal. Also, do not al- 
low liquids, coins, paper clips, and other objects to enter these ventilation 
openings. These objects may damage the terminal. For this reason, do 
not put drinks or metal objects on the top of terminal. 

The terminal may be placed on a desk or table top. However, people usu- 
ally prefer the keyboard at standard typewriter table height rather than 
desk height. Terminal tables and stands are available from DIGITAL Ac- 
cessories and Supplies Group. (Refer to Chapter 1 1 for more information 
on accessories.) 

Position the terminal to avoid reflected light. Usually, the terminal is posi- 
tioned facing away from light sources that reflect off the screen. However, 
if reflected light is a problem, nonreflective and antiglare screens are 
available from DIGITAL Accessories and Supplies Group. Also, antistatic 
mats are available from DIGITAL Accessories and Supplies Group for in- 
stallations with static electricity problems. 
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Figure 8-1 VT125 Terminal Dimensions 
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Table 8-1 Site Considerations 
Consideration Specification 

Temperature 18° to 40° C (50° to 104° F) 

Relative humidity TO to90 percent with a maximum wet bulb temperature 

of 28° C(82° F) and a maximum dew point of 2° C(36° F) 
noncondensing 

Input voltage 90 to 1 28 Vac 1 80 to 256 Vac (switch selectable) 

Power consumption 250 VA apparent 1 50 W maximum 

Power receptacle Nonswitched, grounded 
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Monitor 

Keyboard 

AC power cord 

SET-UP label 

VT 125 User Guide 

VT125 Programming Reference Card 

Inspect the terminal for damage and check that all the listed items are 
present. 

NOTE: If damaged, notify the carrier and your local DIGITAL sales office. 

INSTALLATION PROCEDURE 

The VT125 terminal can be installed using a 3 mm (1 /8 in) blade screw- 
driver. However, more tools may be needed when installing accessories 
and options. Use the following general procedure to install the VT125 ter- 
minal (refer to Figure 8-2 for the switch and cable locations). 

1. Unpack and inspect the terminal. Check that all items in the In- 
spection paragraph are listed. 

2. Check the terminal for the proper voltage range selection. The termi- 
nal can operate with either 120 Vac or 220 - 240 Vac input power. 

CAUTION: Failure to select the proper voltage range will damage 
the terminal. 

A label over the power receptacle indicates the factory selected in- 
put voltage range. Check this label and the voltage selection switch 
to be sure that the voltage range of the terminal is the same as your 
local ac power source. Select the proper input voltage range if 
needed. 
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Figure 8-2 Monitor Controls and Connector Location 

3. Install the correct power cable for your power source. (A list of avail- 
able cables is in Chapter 1 1). 

4. Attach the SET-UP label to the bottom of the keyboard. Remove the 
backing paper on the self-sticking SET-UP label, then attach the la- 
bel. 

5. Place the keyboard in front of the terminal. Plug the keyboard into the 
keyboard connector located at the back of the terminal. 

6. Connect the ac power cable to a nonswitched, grounded ac power 
receptacle. 

NOTE: Check to be sure the power switch is in the OFF position be- 
fore connecting the power cord. 

7. Perform the power-up and checkout procedure in this chapter. When 
these procedures have been completed, continue this installation 
procedure. 



8. Turn off the power and disconnect the power cord. 

9. If needed, install the Advanced Video Option (VT1XX-AB) and the 20 
mA Current Loop Option (VT1XX-CA). Perform the option installation 
and option checkout procedures in Chapter 10. 
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Figure 8-3 Interface Cable Connection 



10. Connect the communication cable to the appropriate connector at 
the back of the terminal. If using the EIA interface, install the EIA line 
filter connector (see note) with a 5 mm (3/ 16 in) screwdriver (Figure 
8-3.) Then fasten the cable connector to the terminal tightening the 
captive screws with a 3 mm (1/8 in) blade screwdriver. Be sure to 
attach the cable ground wire to one of the captive screws. (Refer to 
Chapter 5 for information about connector use and signal/pin defini- 
tions.) 



NOTE: Step 10 also applies to VTWO's that have been upgraded to 
VT125's. Some units do not require the EIA line filter. If your upgrade 
installer did not install the EIA line filter, you do not need to add it at 
this step. 
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11. Connect an optional external video monitor. If the monitor is color, 
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from the VT125 to the inputs on the monitor (Figure 8-2). Connect 
the composite video output from the VT125 to the sync input on the 
monitor, and set the monitor to select external synchronization. 

If the monitor has the ability to pass the video signals to another de- 
vice (loopthrough), be sure that either the monitor (if alone) or the 
last device in the string is set to terminate the video and sync signals 
in 75 ohms. 

If the external monitor is monochrome (black and white), connect 
only the composite video output from the VT125 to the monitor input. 
Be sure the video signal is terminated in 75 ohms. The video output 
signals and the other connector, the video input, are described in de- 
tail in Appendix A. 

12. Connect an optional printer to the auxiliary port. Refer to Chapters 7 
and 2, and the printer's user guide for information about setting the 
communication features of both the printer and the auxiliary port to 
the same values. 

Performing these procedures completes the installation of the termi- 
nal. 



POWER UP AND CHECKOUT PROCEDURE 

A power-up self-test verifies the proper operation of the VT125 terminal 
each time the terminal is powered up. Perform the following procedure to 
power up and checkout the terminal. 

1. Turn the power switch to the ON position (refer to Figure 8-2 for the 
switch location). The terminal automatically runs the power-up self- 
test. The test gives the following indications. 

a. Keyboard and screen flash on and off. 

b. All keyboard indicators turn on and off, and either the ON LINE or 
LOCAL indicator turns on. 

c. The wait message displays on the screen and then is erased. 

d. A bell tone sounds. 

e. A band of light appears at the top of the screen and is erased. 

f. Another bell tone sounds. 
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g. A message appears to announce the result of the VT125 self-test, 
and a box is drawn* around the margins of the graphics screen 
area. (This message stays on the screen until the first character 
arrives over the communication line.) 

NOTE: No messages appear on the screen until the terminal 
warms up. 

h. The text cursor is displayed in the upper-left corner of the screen. 

Any error found by the power-up self-test is displayed on the 
screen as a character, as a message, on keyboard indicators L1- 
L4, or by several bell tones. Refer to the Self-Test Error Codes 
section of Chapter 9 for more information about the error in- 
dications. 

2. If the terminal powers up correctly and you are going to install any 
options, continue with the installation procedure. Then seiect the 
SET-UP features you want as described in Chapter 2. 

3. When the SET-UP features are selected, record the feature selec- 
tions on the SET-UP label attached to the bottom of the keyboard. 



Not on all units 



MAINTENANCE AND 
TROUBLESHOOTING 



GENERAL 

This chapter describes maintenance procedures, troubleshooting (what to 
do in the event of a problem), and self-tests used with the VT125 terminal. 

T_-. . a _ i^...UI^«L«a1 iU ++. J- ^ ■>*•** l^^l n/Mirn^lf l-^x^f/^r-rN r'/'x^ii motion O Ofi/i^O 

I fy 10 trOuDiesnuOl lilt? idiiiniai yuuiocn uciwic iccjucbuny bt?iviv^. 

MAINTENANCE 

The VT125 terminal needs no preventive maintenance. However, its cabi- 
net may be cleaned with any mild detergent that does not use solvents. 

CAUTION: Do not use too much detergent when cleaning the terminal. If 
liquids get inside the terminal, it may be damaged. 
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or tissue and then clean the terminal. 

2. To clean the screen, apply the detergent to a cloth or tissue and 
then clean the screen. 

3. To clean the keys, rub with a dry or moist cloth. 

CAUTION: Do not remove the keycaps when cleaning; the key- 
switch contacts can be damaged if the keycaps are replaced in- 
correctly. 

WHAT TO DO IN THE EVENT OF A PROBLEM 

If the terminal appears to be faulty, perform the following procedure. If the 
problem is not solved by this procedure, refer to Table 9-1 for a list of typi- 
cal problems. 

1. Turn the power switch to the OFF position. Check the following. 

a. Power Cord - Be sure the cord is connected securely at both the 
terminal and at the wall outlet. Check the wall outlet with another 
device, such as a lamp, to be sure that it is providing ac power. 
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Symptom 

ON LINE or LOCAL 
indicator is on with no 
cursor on screen. 

ON LINE or LOCAL 
indicator is not on 
with no keyboard 
response. Cursor is 
on screen. 



Possible Cause 

Screen brightness is 
too low. 



Keyboard cable is not 
connected to terminal. 



Corrective Action 

Enter SET-UP and 
increase the screen 
brightness. 

Turn off terminal and 
connect keyboard cable. 



KBD LOCKED indi- 
cator is on. 



Keyboard buffer is full, 
keyboard cannot 
accept more charac- 
ters. Terminal was 
XOFFed by computer. 



Entering and exiting 
SET-UP clears this 
condition. 



CAUTION: Characters may be lost using this procedure. 
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Wrong or substitute 
($) characters or no 
characters appear on 
the screen. 
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sound during power 
up. Reset or Recall. 



Screen can not be up- 
dated by the computer 
because terminal has 

Print operation cannot 
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SET-UP feature 
selection is incorrect 



Computer has made 
an error. 



problem with user 
permanent memory. 
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Check printer. 



Correct the SET-UP fea- 
tures. Suggested SET-UP 
features that may be in 

ANSI/VT52 mode 
Auto XON/XOFF 
Bits per character 
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Receive speed 
Transmit speed 

Check computer 
system. 



feature settings and try 
the save operation. 
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b. Voltage Selection Switch and Fuse - Be sure the switch is in the 
correct position and the fuse is good. (Remove the fuse holder 
cap by pressing it in and turning it counterclockwise. Replace the 
fuse holder cap by pressing it in and turning it clockwise.) 

c. Keyboard Coiled Cord - Check that the cord is securely plugged 
into the keyboard connector at the back of the terminal. 

2. Turn the power switch to the ON position. The terminal performs the 
power-up self-test. (Refer to Power-Up Self-Test on page 215 for 
more information about the power-up test.) If the terminal does not 
power up correctly, call your local DIGITAL service office. 

3. If needed, perform the computer port data loopback self-test with a 
loopback connector. (Refer to the Loopback Test descriptions on 

npna "1 P frtr mnro infnrma+inn ^ 



VT125 SELF-TESTS 

The VT125 terminal has several self-tests available for checking the oper- 
ation of the terminal. The VT125 is a graphics processor residing in a 
VT100 terminal. Some self-tests check the VT100. The other tests are for 
the graphics processor itself. 

The power-up self-test is performed each time the terminal is powered up. 
The other tests may be performed after the power-up self-test is com- 
pleted. To perform the other tests the terminal must be discc pnected from 
the communication line and an external loopback connector installed. 

Preparing for Self-Tests 

Use this procedure to prepare the terminal for all self-tests except a 
single power-up test. 

1. Press the power switch to the OFF position. 

2. Disconnect the communication cables from the computer and aux- 
iliary data ports. The computer port communication cable may be ei- 
ther EIA or 20 mA. 

3. If a cable was connected to the EIA computer port connector, install 
an EIA loopback connector on the EIA connector (Figure 9-1). The 
EIA loopback connector part number is 12-15336. One loopback con- 
nector was shipped with the terminal or upgrade kit. 

4. If a cable was connected to the 20 mA connector, the 20 mA Current 
Loop Adapter Option is installed. Install the loopback connector 
(DIGITAL PN 70-15503-00) that was included with the option. Do not 
use the EIA loopback connector at the same time as the current loop 
connector. 
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Figure 9- 1 EIA Loopback Connector 



To perform the auxiliary port tests, install an EIA loopback connector 
on the auxiliary port connector. If the communication port is EIA, you 
need a second EIA loopback connector (refer to Chapter 1 1 for or- 
dering information). 



6. Turn the power switch ON. 

7. Be sure the terminal is ON LINE with the ANSI/VT52 SET-UP B fea- 
ture selected to ANSI (SET-UP B switch 2-3 = 1). 
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POWER-UP SELF-TEST 

A power-up self-test is built into the VT125 terminal to test the operation 
of the terminal. The test checks the general operation of the VT100 termi- 
nal, including the Advanced Video Option if installed, the user permanent 
SET-UP feature memory and the keyboard, and the general operation of 
the graphics processor, including the bit map memory. 

To perform the power-up self-test, turn the terminal on. Or if power is on, 
enter SET-UP and press the (RESET) key. Prepare the terminal for self- 
test if the test must be run continuously, and type one of the following se- 
quences to perform the test. 

ESC [ 4 ; 1 y Performs the power-up self-test once 

ESC [ 4 ; 1; 9 y Performs the power-up self-test continuously 

NOTE: This test can also be performed with the VT100 power-up test se- 

— _ / ^ror>^ m.i.,\ tu~ /« An «i' n ,. A .. n f.. ,-»,-■«, v. ^ +•->,-.+ ^ n w» ^n/t/ if <*n .«*•_ 
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ror is found or if power is turned off. 
The test gives the following indications. 

• Keyboard and screen flash on and off. 

• All keyboard indicators turn on and off, and either the ON LINE or LO- 
CAL indicator is turned on. 

• The wait message displays on the screen and then is erased. 

• A bell tone sounds. 

• A band of light appears at the top of the screen and is erased. 

• Another bell tone sounds. 

• A message appears to announce the result of the VT125 self-test, 
and a box is drawn* around the margins of the graphics screen area. 

NOTE: No messages appear on the screen until the terminal warms 
up. 

• The text cursor displays in the upper-left corner of the screen. 

Any error found by the power-up self-test displays on the screen as a 
character, as a message, on keyboard indicators L1-L4, or by sever- 
al bell tones. Refer to the Self-Test Error Codes section of this chap- 
ter for more information about the error indications. 



'Not on all units. 
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COMPUTER PORT DATA LOOPBACK SELF-TEST 

The computer port data Soopback test checks that the VTi 25 terminal can 
transmit and receive characters over the computer data port. The com- 
puterport must havetheloopbackconnectorinstalled. Referto Preparing 
for Self-Tests on page 213. 

To perform the data loopback self-test, type one of the following se- 
quences. 

ESC [ 4 ; 1 ; 2 y Performs the power-up and computer 

port data loopback self-tests 

ESC [ 4 ; 1 ; 2 ; 9 y Performs the power-up and computer 

port data loopback self-tests 
continuously until failure 

NOTE: The continuously running test ends only if an error is found or if 
power is turned off. 

The test gives the following indications. 

• Either the ON LINE or LOCAL indicator turns on. 

• The wait message displays on the screen and then is erased. 

• The cursor displays in the upper-left corner of the screen. 

• If the computer port data loopback test fails, the message "VT125 
EC Error" displays on the internal monitor. 

Turn the power switch OFF. Remove the loopback connector and connect 
the communication cable. 
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AUXILIARY PORT DATA LOOPBACK TEST 

The auxiliary port data loopback test checks that the VT125 terminal can 
transmit and receive characters over the auxiliary data port. Both the 
computer port and the auxiliary port must have loopback connectors in- 
stalled. 

To perform the auxiliary port data loopback test, type one of the following 
sequences. 

ESC [ 4 ; 1 ; 3 y Performs the power-up and auxiliary port 

data loopback self-tests 

ESC [ 4 ; 1 ; 3 ; 9 y Performs the power-up and auxiliary port 

data loopback self-tests continuously until 
failure 

NOTE: The continuously running test ends only if an error is found or if 
power is turned off. 



The test gives the following indications. 

• Either the ON LINE or LOCAL indicator turns on. 

• The wait message displays on the screen and then is erased. 

• The cursor displays in the upper-left corner of the screen. 

• If the test fails, the message "VT125 SC Error" displays. 

Turn the power switch OFF. Remove the loopback connector and connect 
the communication cable. 
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DISPLAY TEST 

iiiiS iSSi requires you iO CmGCk me screen gi tuG intGrnal monitor and the 
color monitor (if present) for correct operation. The screen cycles through 
the four intensity levels of each of the three primaries and white to test 
the output memory. The computer data port must have the loopback con- 
nector installed. 

To perform the display test, type one of the following sequences to per- 
form the test. 



ESC [ 4 ; 1 ; 4 y 
ESC [ 4 ; 1 ; 4 ; 9 y 



Performs the power-up and display self- 
tests 

Performs the power-up and display self- 
tests continuously until failure 



NOTE: The continuously running test ends only if an error is found or if 
power is turned off. 

The test gives the indications listed in Table 9-2. 



Table 9-2 Display Test Indications 
Step Monochrome 

1 Black White Light Dim 

Grey Grey 

2 Dim Black White Light 
Grey Grey 



Light Dim 
Grey Grey 



Black White 



White Light Dim Black 

Grey Grey 

White Light Dim Black 

Grey Grey 



Color 

Black Light Black Black 
Red 

Dim Dim Dim Dim 

Blue Red Green Grey 

Light Light Light Light 

Blue Red Green Grey 

Light Light Light Black 

Green Red Blue 

Black Black Black Black 
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VIDEO BIT MAP MEMORY TEST 

This test checks that every bit in both video bit map planes can be written 
to both one and zero. The computer data port must have the loopback 
connector installed. 

To perform the video bit map memory test, type one of the following se- 
quences. 

ESC [ 4 ; 1 ; 5 y Performs the power-up and video bit map 

memory tests 

ESC [ 4 ; 1 ; 5 ; 9 y Performs the power-up and video bit map 

memory tests continuously until failure 

NOTE: The continuously running test ends only if an error is found or if 

rtrsuiar ic it irnari /~>ff 

The test gives the following indications. 

• The screen fills with levels of intensity (or color) moving from top to 
bottom. 

• If this test fails, the message "VT125 BM Error" is displayed. 
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VT125 SELF-TEST ERROR CODES 
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self-test, or if the complete screen flashes, request service for the termi- 
nal. 

If a character appears under the blinking cursor at the top left corner of 
the screen, or a message appears in the center of the screen, check 
Table 9-3 for the meaning of the error code character or message. Note 
that the character displayed could mean that more than one error has 
been detected. To clear the error indication after the error is corrected, 
reset or power up the terminal. 



Table 9-3 Displayed Error Codes 



Character 
Displayed 

1 
2 
3 
4 
5 
6 
7 





Faults Detected 


AVO 


Memory Keyboard 


X 






X* 


X 


X 




xt 


X 


X 




X X 


X 


X X 



Message 
Displayed 

VT125 0K 
VT1 25 Offline 

VT1 25 BM Error 
VT1 25 VG Error 
VT1 25 IC Error 
VT125SC Error 
VT1 25 EC Error 



Faults Detected 

None - normal power up test results. 

VT1 00 text terminal is LOCAL LOCAL was saved in SET-UP, 
or User Permanent Memory problem. 

Video Bit Map Memory. One or more pixels are bad 
Vector generator 
Internal communications 
Auxiliary port 
Computer port 



* Also, bell tones are generated - perform a Save and Recall in SET-UP. 
t Be sure keyboard is properly connected. 
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There are three types of errors indicated by the self-test code characters. 



Advanced Video Option 
(AVO) if installed 



User Permanent SET-UP 
Feature Memory failure 
(memory) 



If the advanced video option 
fails, the terminal operates 
with the basic VT100 text 
capabilities. 

If the user permanent SET-UP 
feature memory fails, the 
terminal operates using default 
SET-UP feature selections for each 
of the features. (Refer to Chapter 
2 for more information on the 
SET-UP feature memories.) 

ii uniy me i\tjyuOeiiu iciiio, me 

terminal ends the test ON LINE, 
so that it may operate as a 
receive-oniy terminal. The SET-UP 
feature selections cannot be 
changed. 



There are six types of errors indicated by the self-test error messages. 

VT125 Offline VT100 text terminal is LOCAL. LOCAL was saved 

in SET-UP, or user permanent memory problem. 
Terminal can only process received graphics 
commands. 



Keyboard missing or 
malfunction (keyboard) 



VT125BM Error 
VT125VG Error 

VT125IC Error 

VT125SC Error 
VT125 EC Error 



Video bit map memory has one or more bad pixels. 

Vector generator could not draw sample shape. 
Graphics probably does not work, but terminal may 
communicate normally. 

Internal communications failed. VT125 cannot 
communicate with VT100. Terminal can only 
process received graphics. 

Auxiliary port failed data loopback test. Terminal 
cannot send data to printer. 

Computer port failed data loopback test. Terminal 
can only operate as text terminal in LOCAL. 
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A box is drawn around the margin of the graphics screen area.* If any part 
of me box is missing or distorted, the graphics board needs service. 

Table 9-3 shows the possible error characters that are displayed on the 
screen and the failure indicated by each character. Notice that the char- 
acter displayed could indicate that more than one error has been found. 



*Not on a!! units. 



OPTIONS 



GENERAL 

The VT125 Graphics Terminal is a VT100 text terminal with a factory-in- 
stalled graphics processor. There are two more options that can be in- 
stalled into the VT125 at its operating location. They are the 20 mA Cur- 
rent Loop Option and the Advanced Video Option. Other options that can 
be used with the VT125 are a color monitor and a graphics hardcopy 
printer, installation of the monitor and prinier is explained in the installa- 
tion chapter (Chapter 8). This chapter explains the installation of options 
into the VT125 itself. 

This chapter also explains the installation of the VT1XX-CB and -CL 
graphics processors into the VT100 and VT105. 

20 mA CURRENT LOOP INTERFACE OPTION (VT1XX-CA) 

This option is an optional interface used to connect the VT125 terminal to 
a computer. The 20 mA option is a board installed into the VT125 terminal 
and an interface connector. Figure 10-1 shows the 20 mA current loop in- 
terface connector and pin assignments. The 20 mA current loop interface 
Option can operate at a distance up to 300 meters (1000 feet). 

NOTE: The VT125 terminal is designed to use either 20 mA or El A com- 
munications. If EIA is used on a terminal that has the 20 mA option in- 
stalled, the cable connecting the 20 mA option board to the terminal con- 
troller board must be disconnected. 

Both the transmitter and receiver of the 20 mA interface board can be se- 
lected for active and normal (passive) operation. The terminal is usually 
connected for normal (passive) operation. Operation is passive when the 
terminal does not supply the 20 mA current needed during commu- 
nication. The transmitter goes to the mark condition when power is turned 
off. 

Operation is active when the terminal supplies the 20 mA current needed 
during communication. In an active configuration, there is no isolation and 
the transmitter goes to the space condition when power to the terminal is 
turned off. 
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SCREWS (4) 



RGB VIDEO CABLES 



KEYBOARD 

CABLE 

CONNECTOR 



PIN ASSIGNMENT 


1 


TEST NEGATIVE 


2 


TRANSMIT - 


3 


RECEIVE - 


5 


TRANSMIT + 


7 


RECEIVE + 



FUSE 




ACCESS 
COVER 



EIA 

AUXILLIARY 

PORT 



EIA 

COMPUTER 
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.POWER 
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Figure 10-1 20 mA Connector and Pin Locations 



Installation 

The tools needed to install this option are a 5 mm (3/ 16 in) blade screw- 
driver and a number 2 Phillips screwdriver. Use the following procedure to 
install the 20 mA current ioop option. 

1. Turn power switch to the OFF position and disconnect the power 
cord (Figure 10-1). 

2. Unplug the keyboard. 

3. If installed, disconnect any video cables. 

4. If installed, disconnect any communication cables. 

5. With a number 2 Phillips screwdriver, remove the four screws holding 
the VT125 access cover in place (Figure 10-1). Remove the access 
cover. 

6. Install the 20 mA current loop option board onto the access cover 
with the three Phillips screws provided with the option (Figure 10-2). 

7. Use a 5 mm (3/16 in) screwdriver and the two hexhead screws (pro- 
vided with the option) to install the 20 mA connector to the bottom of 
the access cover. 
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ADAPTER 
CABLE 



20mA CURRENT LOOP 
BOARD MOUNTING 
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CURRENT 

LOOP CONNECTOR 
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NOTE: ACCESS COVER 
MAY HAVE DIFFERENT 
OPENINGS. 



Figure 10-2 20 mA Current Loop Option Board Installation 

8. Select TRANSmit and RECeive switches for the proper configuration 
(Figure 10-3). 

NOTE: These switches must be selected for NORMAL (passive) op- 
eration to perform the loopback test. The loopback test verifies prop- 
er operation of the option after installation. 

9. Connect the adapter cable P5 to J5 on the terminal controller board. 
Note that the connector fits only one way. Place the access cover 
next to the opening in the back of the terminal. Connect the other 
end of the cable to the 20 mA board (Figure 10-4). 

10. Place the access cover into the opening of the terminal and tighten 
the four screws to fasten it. 



1 1. Perform the computer data port loopback test. 
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NOTE: ACCESS COVER 
MAY HAVE DIFFERENT 
OPENINGS. 
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Figure 10-3 20 mA Current Loop Option Switches 




NOTE: P5 CABLE 
SHOWN LONGER FOR 
CLARITY 



TERMINAL 

CONTROLLER 

BOARD 



Figure 10-4 20 mA Current Loop Option Cable Position 
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Computer Data Port Loopback Self-Test 

This test checks that the VT125 terminal can transmit and receive char- 
acters over the computer data port. The transmit and receive lines must 
be connected to each other with an external loopback connector. 

To perform the data loopback self-test, use the following procedure. 

1. With the power switch OFF, disconnect the communication cable. In- 
stall the loopback connector (DIGITAL PN 70-15503-00), included 
with the option, on the computer data port connector (Figure 10-5). 

2. Turn the power switch ON. The terminal performs the power-up self- 
test. 
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Figure 10-5 20 mA Loopback Connector 
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3. Be sure the terminal is ON LINE with the ANSI/VT52 SET-UP B fea- 
ture selected to ANSI (SET-UP B switch 2-3 = 1). The terminal trans- 
mit and receive speeds must be the same and 300 baud or faster. 
Type one of the following sequences to perform the test. 

ESC [ 4 ; 1 ; 2 y 

033 133 064 073 061 073 062 171 

Performs the power-up and computer data port loopback self-tests. 

ESC [ 4 ; 1 ; 2 ; 9 y 

033 133 064 073 061 073 062 073 071 171 

Performs the power-up and computer data port loopback self-tests 
continuously until failure. 

NOTE: The continuously running test ends only if an error is found 
or if power is turned off. 

The test gives the following indications. 

a. Either the ON LINE or LOCAL indicator turns on. 

b. The wait message displays on the screen and then is erased. 

c. The cursor displays in the upper-left corner of the screen. 

d. If the computer data port loopback test fails, the message "VT125 
EC Error" is displayed on the internal monitor. 

4. Turn the power switch OFF. Remove the loopback connector and 
connect the communication cable. 

Advanced Video Option 

This option adds the following features to the text terminal capabilities of 
the VT125. 

1. Ten additional lines of 132-column display - The screen can now dis- 
play a total of 24 lines in either 80- or 132-column format. 

2. Additional character attributes - Any text terminal characters can 
now be highlighted in any of the following ways: bold, blink, underline, 
reverse, or any combination of the four. 

3. Capability to use an additional character generator ROM, for another 
resident character set. 
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Installation 

Use the following procedure to install the VT1XX-AB Advanced Video op- 
tion. A number 2 Phillips screwdriver is needed to install this option. 

1. Turn the power switch OFF and disconnect the power cord (Figure 
10-1). 

2. Unplug the keyboard. 

3. If installed, disconnect any video cables. 

4. If installed, disconnect any communication cables. 

5. With a number 2 Phillips screwdriver, remove the four screws holding 
the access cover in place (Figure 10-2). Remove the access cover. 

6. If a 20 mA current loop option is installed, disconnect the short cable 
from the current ioop option board (Figure 10-4). 

7. Remove the ground wires from the terminal controller and graphics 
processor boards. 

8. Loosen the two large boards from their sockets, one at a time, and 
then pull them out together about 5 cm (2 in). 

9. Remove both flat cables from the graphics processor board. See the 
VT100 upgrade procedure illustrations in this chapter. 

10. Remove the terminal controller board from the chassis. 

1 1. Locate the four mounting holes drilled in the terminal controller board 
for the Advanced Video Option (AVO) and mount a plastic standoff in 
each hole (Figure 10-6). 

12. Holding the AVO board by the edges, align the AVO connector with 
the pins on the terminal controller board. Press the board into place. 

13. Slide the terminal controller partially into the chassis and reconnect 
the two flat cables to the graphics processor board. 

14. Reconnect the ground wires to the terminal controller and graphics 
processor boards. 

15. Slide both boards into the chassis together, taking care not to 
stretch the cables. Seat both boards in their sockets, one at a time. 
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STANDOFFS (4) 



COMPONENT SIDE 
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J9 VIDEO OUT 
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J7 KEYBOARD 
CONNECTOR 



Figure 10-6 Advanced Video Option Location and Installation 



16. Place the access cover into the opening of the terminal, replacing 
the 20 mA adapter cable if present, and tighten the four screws. 

17. Replace the power cord. 

18. Perform the advanced video option test. 

Advanced Video Option Test 

Use the following procedure to check out the operation of the Advanced 
Video Option. 

1. Turn the terminal power on and check that no error was detected 
during the power-up self-test. 

2. Press SET-UP. The words SET-UP A should blink in boldface, the 
words TO EXIT PRESS SET-UP should be underlined, and the tab rul- 
er at the bottom of the screen should have alternating normal and 
reverse video sections even if the cursor is selected to underline. 

3. Place the terminal in 132-column mode and then in LOCAL. 

4. Exit SET-UP and type the following sequence. 
ESC < ESC # 8 

The screen should now display 24 lines X 132 columns. 
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NOTE: ROMS MAY BE 
INSTALLED IN ANY 
ORDER ON TERMINAL 
CONTROLLER BOARD. 



Figure 10-7 Check ROM Numbers 



VT1XX-CB OR -CL INSTALLATION INTO VT100 AND VT105 

The VT1XX-CB or -CL is a kit of all the parts needed to install a VT125 
graphics processor into a VT100 or VT105. 

NOTE TO CUSTOMER: Please do not try to install this complex option. 
Call your DIGITAL Field Service branch for assistance. 

NOTE: Before installing the graphics processor, check the ROMs and 
the etch revision level on the terminal controller board (at step 7 of this 
procedure). Compare the numbers of the ROMs on the board with the 
numbers in Figure 10-7. They should be equal or larger. 

Check the etch number on the solder side of the board. Look for the num- 
ber 5013008 followed by a letter. If the letter is D, E, etc., the board can be 
used. If the letter is A, B, or C, you cannot use the board. Use the EIA line 
filter connector (included in kit) with a REV F board. 



If either of these prerequisites cannot be met, consult your Field Service 
branch office for information. 
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INSTALLATION 

The tools needed to install the VT1XX-CB or -CL are the following: 1/4 
inch nutdriver, number 2 Phillips screwdriver, needlenosed pliers, and 
3/16 inch blade screwdriver. Use the following procedure to install the 
VT1XX-CBor-CL. 

1. Turn off the power and disconnect the power cord. 

2. Unplug the keyboard. 

3. Remove the access cover (4 Phillips screws or four slotted plastic 
screws). (Refer to Figure 10-1.) If a 20 mA current loop option is in- 
stalled, disconnect the short cable from the terminal controller board 
(Figure 10-4). 

4. Remove the shipping bolts if installed (1/4 inch hexhead). You can 
discard them. 

5. Release the pop fasteners at the front and back of the terminal with a 
blade screwdriver and remove the top cover (Figure 10-8). 

6. Release the pop fasteners at the front and back of the chassis with 
your fingers and remove the chassis from the bottom cover. 

7. Remove the terminal controller board from the chassis. 

8. On VT100: Remove the terminal controller edge connector in either 
of two ways. 

a. Release the two retaining rings from the edge connector with nee- 
dlenosed pliers. 

b. Lift the clips at the top and bottom of the edge connector and dis- 
card the clips. 

On VT105: Disconnect the power cable from the VT105 expansion 
backplane and remove the backplane (Figure 10-9). 

9. The new expansion backplane has two capacitors on it, and its ter- 
minal controller edge connector has an alignment key in it. Remove 
this key with needlenosed pliers unless installing the option in a ter- 
minal with a Revision F or higher terminal controller board. Install the 
new expansion backplane with four 12.7 mm (1/2 in) X 4-40 screws 
and keps nuts and four 6.4 mm (1/4 in) spacers. Install the screws at 
the connector positions marked J1 and J5 on the board (Figure 10- 
9). The dc power cable must be flat against the chassis or the back- 
plane will not fit. 
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Figure 10-8 Top Cover Removal 
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Figure 10-9 Expansion Backplane Installation 



10. Use needlenosed pliers to remove the alignment key, if installed, 
from the connector opening in the dc power cable. Bend the dc pow- 
er cable around so that the opening faces the CRT. Install the con- 
nector onto the board edge connector, passing the cable around the 
wire frame if it is present (Figure 10-9). 

11. Install card guides into the top and bottom of the card cage at the 
VT125 connector position. 



12. At the fourth hole from the left on the chassis top (over the BNC 
bracket) press the ground clip with a wire onto the chassis (Figure 
10-10). 
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NOTE: 

INSTALL CLIP BEFORE 
imctai i iMn cuici n 



Figure 10-10 instaiiing Ground Clips 



13. Install the FCC RF shield (Figure 10-11). 

a. Loosen, but do not remove, two Phillips screws at the top of the 
chassis. 



b. Set the chassis on end with the cage up. 

NOTE: The terminal rests on several parts that stick out on the 
bottom. Set the terminal on a protected surface to prevent dam- 
age. 

There are bumpers attached to both sides of the chassis. They 
protect the terminal during shipping and can be removed now if 
needed. 

c. Loosen, but do not remove, two Phillips screws at the bottom of 
the chassis. 

d. Slide the shield onto the cage. 

e. Tighten the four Phillips screws. 
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Figure 10-1 1 RF Shield Installed 

14. Put the chassis into the bottom cover and press the pop fasteners to 
close them. Put the top cover over the terminal and press the pop 
fasteners to close them. 

15. Slide the terminal controller board partially into the chassis. 



16. Install the VT100 end of the 16-pin flat cable connector to the lower 
16 pins of the terminal controller board's graphic connector (marked 
J2 on the terminal controller board) with the cable entering from the 
right (Figure 10-12). 
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Figure 10-12 16-Pin Flat Cable on Terminal Controller 



17. Install the STP board in the STP connector. Lift the 16-pin cable 
slightly if needed to clear the spacer when inserting the STP board. 
Attach it to the terminal controller board with the supplied screw and 
washer (Figure 10-13). 

18. Find the end of the 24-pin cable that has pin 1 on the cable side. 
(The red stripe should be on the left.) Fold the cable under itself to 
the right approximately 3 cm (one inch) from the connector. Install 
that end into the socket on the STP board with the cable down (Fig- 
ure 10-14). 



19. Install the VT125 board into the chassis so that it sticks out approx- 
imately 5 cm (2 in) more than the terminal controller board. 

20. Arrange the 16-pin graphic connector with the cable entering from 
above and install it into the connector at the top edge of the VT125 
board (Figure 10-15). 

21. Arrange the 24-pin connector with the cable entering from the right 
and install it into the 24-pin socket at the right edge of the VT125 
board (Figure 10-15). 
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STANDOFF 



NYLON WASHER 




Figure 10-13 STP Board Installation 
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Figure 10-14 24-Pin Flat Cable on STP Board 
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STP 
BOARD 




24 PIN CABLE 



TERMINAL 

CONTROLLER 

BOARD 



Figure 10-15 Graphic Cable Connections 



22. Check the switches on the STP board and set switches 1, 3, and 4 
OFF, with all the other switches ON (Figure 10-16). 

23. Connect the ground wire from the top of the chassis to the quick- 
connect terminal on the BNC connector bracket (Figure 10-17). 

24. Slide both boards into the chassis together, taking care not to 
stretch the cables. Seat both boards in their sockets, one at a time. 



25. If the 20 mA adapter was installed on the VT100, remove the adapter 
board from the VT100 access cover and install it into the new access 
cover. (Refer to procedure in this chapter.) 

26. Install the 20 mA connector cable (if present) to the red connector on 
the terminal controller board. 

27. Adjust the cables in the access opening and install the access cov- 
er, tightening the four screws carefully. 

28. Perform the installation, power-up, and checkout procedure that is 
described in Chapter 8. If using the EIA interface on a REV F etch 
board, be sure to install the EIA line filter connector as shown in Fig- 
ure 8-3. 
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Figure 10-16 STP Board Switches - Variations 
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GROUND WiRE 
&CLIP 




BNC BRACKET 
ON GRAPHICS 
PROCESSOR 
BOARD 



Figure 10-17 Connecting BNC Bracket and Ground Wire 




Figure 1 0-1 8 interface Cable Connection 



ACCESSORIES 
AND SUPPLIES 



GENERAL 

This chapter describes accessories and supplies offered by DIGITAL for 
the VT125 terminal. Included in this chapter is a description of the acces- 

complete listing of accessories and supplies available from DIGITAL, see 
the DECdirect cataiog. (See Ordering information for the number to call for 
a free copy.) 

ACCESSORIES 

Part Number 

VT1XX-AE 

VT1XX-AR 

VT1XX-AW 

VT1XX-AX 

VT1XX-AY 

VT1XX-FA 

VT1XX-FB 

VT1XX-FC 

VT1XX-SA 

VT1XX-ST 

VT1XX-SU 

VT1XX-SV 



Description 

VT100 formed screen filter, grey, antiglare coating 

VT100 nonreflective filter screen 

VT100 formed screen filter, green 

VT100 formed screen filter, light green 

VT100 formed screen filter, amber 

Gray antiglare filter kit 

Green antiglare filter kit 

Bronze antiglare filter kit 

VT100 series tilt-swivel base 

VT100 terminal stand with casters 

VT100 terminal table (VT1XX-ST), lot of 25 

VT100 terminal table (VT1XX-ST), lot of 50 
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ACCESSORIES 
Part Number 

H9850-HK 
H980-CS 

H980-CP 

VT1XX-KA 

VT1XX-KB 

VT1XX-KC 

VT1XX-KD 

DF01-A 

DF02-AA 

DF02-AC 
DF03-AA 

DF03-AC 

30-10958-02 

VT1XX-CA 

VT1XX-AB 

VT1XX-CB 



Description 

Heavy gauge vinyl dust cover, charcoal brown 

Catalog stand with eight one-inch removable 
cartridges for 8-1/2 inch X 1 1 inch documentation 

Cartridges for catalog stand 

KED/EDT keypad overlay 

FMS/FED keypad overlay 

FMS/FDV keypad overlay 

Numeric pad, clear overlay 

Acoustic telephone coupler, 300 bits per second 
with combination EIA (RS232-C) and 20 mA loop 
cable 

Modem, full-duplex, direct connect, originate and 
auto answer, 300 pits per second, Bell 103J 
equivalent with RS232-C interface. 

DF02-AA with auto originate capability 

Direct connect, Bell 212A equivalent 300/1200 bits 
per second full-duplex, modem 

DF03-AA with auto originate capability 

Cable to interface older DF01 couplers to VT100 

20 mA current loop option with cable 

Advanced video option 

VT100 upgrade kit for VT125 graphics capability 
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ACCESSORIES 
Part Number 

H9850-DA 

H9850-DB 
H9850-DC 
H9850-DD 



H9850-DE 



H9850-DF 



H9850-DH 



H970-EB 



H970-HB 



H9614-AD 



H9614-AB 



H9850-AP 



Description 

Antistatic floor mat, DECmat, 122 cm X 183 cm (4 
ft X 6 ft), Driftwood color (brownish grey) 

Antistatic floor mat, DECmat, 122 cm X 183 cm (4 
ft X 6 ft), Summer Earth color (brown /gold) 

Antistatic floor mat DECmat, 91 cm X 305 cm (3 ft 
X 10 ft), Silver Birch color (silvergrey/ brown) 

Antistatic floor mat, DECmat, 91 cm X 305 cm (3 ft 
X 10 ft), Autumn Bronze color (orange /brown) 

Antistatic floor mat, DECmat, 91 cm X 305 cm (3 ft 

/s, I VJ ii/, i-m ii iw*J\J\J V/Uiui \uiwhiiioii y^J/ 

Antistatic floor mat, DECmat, 122 cm X 183 cm (4 
ft X 6 ft), Silver Birch color (silvergrey /brown) 

Antistatic floor mat, DECmat, 122 cm X 183 cm (4 
ft X 6 ft), Autumn Bronze color (orange /brown) 

Terminal table, 68.6 cm high X 91.4 cm wide X 
76.2 cm deep (27 in X 36 in X 30 in) with levelers 

Terminal table, 68.6 cm high X 61.0 cm wide X 
76.2 cm deep (27 in X 24 in X 30 in) with levelers 

Workstation desk, add-on split top design 
especially for VT100. Light grey with charcoal 
brown end panels. 100.33 cm wide X 76.2 cm X 
76.2 cm high (39.5 in X 30 in X 30 in) 

Workstation desk, split top design especially for 
VT100. Light grey with charcoal brown end panels. 
100.33 cm wide X 76.2 cm X 76.2 cm high (39.5 
in X 30 in X 30 in) 

Media Mate™, file or shelf storage cart with casters 
and lockable drawer, 64.1 cm high X 38.1 cm deep 
X 47.0 cm wide (25.25 in X 15 in X 18.5 in) 
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KEYCAPS 
Part Number 

LA12X-UA 

LA12X-UB 

LA12X-UC 

LA12X-UD 

LA12X-UE 

LA12X-UF 

LA12X-UH 

LA12X-UJ 

LA12X-UL 

LA12X-UM 

LA12X-UN 

LA12X-UP 

LA12X-UR 

LA12X-US 

LA12X-UT 

12-14333-CO 

12- 14333- JO 

12-14333-72 

12-14333-91 



Description 

Blank keycap kit of 50, Row 4* 

Blank keycap kit of 50, Row 1 * 

Blank keycap kit of 50, Row 2* 

Blank keycap kit of 50, F&J type 

Blank keycap kit of 50, SET-UP 

Blank keycap kit of 50, TAB 

Blank keycap kit of 50, CAP LOCK 

Blank keycap kit of 50, SHIFT 

Main array blank keycap set 

Blank keycap kit of 50, CR 

Blank keycap kit of 50, ENTER 

Blank keycap kit of 50, Num Pad 

Blank keycap kit of 50, Row 3 

Blank keycap kit of 50, Row 5 

Numeric pad blank keycap set 

Complete set of 82 keycaps for DECform VT100 

Complete set of 82 keycaps for Word Processing 
VT100 

Set of 64 keycaps for main array on standard 
VT100 

Set of 18 keycaps for numeric pad on standard 
VT100 



Row 1 is the row immediately above space bar. 
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CABLES 
Part Number 

BC22A-25 

BC22B-10 

BC22B-25 

BC23A-10 
BC23A-25 
BC23B-iO 
BC23B-25 



Description 

EIA RS232 female-female null modem cable 
shielded 7.6 m (25 ft) 

EIA RS232 male-female extension cable shielded 
3.0 m (10 ft) 

EIA RS232 male-female extension cable shielded 
7.6 m (25 ft) 

Kitof5BC22A-10 

Kit of 5 BC22A-25 



MI OT O DOZZB- 1U 



Kit of 5 BC22B-25 



NOTE: EIA RS-232-C specifies a maximum cable length of 15 m (50 ft), 
EIA RS-423 specifies a maximum cable length of 61 m (200 ft). 



BC03M-50 

BC03M-AO 

BC03M-B5 

BC03M-EO 

BC03M-LO 

BC05X-15 

BC05X-25 

BC05X-50 

BC22A-10 



Female-female null modem cable, 15.2 m (50 ft) 

Female-female null modem cable 30.5 m, (100 ft) 

Female-female null modem cable, 76.2 m (250 ft) 

Female-female null modem cable, 152.4 m (500 ft) 

Female-female null modem cable, 304.8 m (1000 ft) 

20 mA current loop extension cable, 4.6 m (15 ft) 

20 mA current loop extension cable, 7.6 m (25 ft) 

20 mA current loop extension cable, 15.2 m (50 ft) 

EIA RS232 female-female null modem cable 
shielded 3.0 m (10 ft) 
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POWER CORDS 



Part Number 

17-00083-09 
17-00083-10 
17-00209-00 
17-00199-00 
17-00211-00 
17-00198-00 



Description 

United States (120 V) 

United States (240 V) 

United Kingdom 

Continental Europe (SCHUKO) 

Switzerland 

Australia 



HARDWARE AIDS 



Part Number 

12-15336 
70-15503 

TOOLS 



Description 

Data loopback connector for RS232C 
Data loopback connector for 20 mA 



74-16355 

SPMAK-AA 

SPMAK-AB 



Keycap puller 

VT101 / 102/ 125/ 131 maintenance aid kit RS232 

VT101 / 102/125/131 maintenance aid kit 20 mil 



ALIGNMENT TEMPLATES 



94-03220-3 

94-03246-3A 

94-03246-3B 

SPARES KIT 



Screen alignment template 
Character width template 
Character height template 



4A-VT 1 25-00 VT 1 25 Spares kit 

LOT PRICED KITS (Packaged in quantities of 10) 



4A-LOTVT-EC 
4A-LOTVT-EB 
4A-LOTVT-AC 
4A-LOTVT-AD 



Flyback & choke assembly 
Monitor board 
Basic video board 
Power supply 



COMPONENTS AND LOOSE PIECE PARTS 



Modules, subassemblies and other individual piece parts to support the 
specific VT125 repair philosophy are available from Digital's Accessories 
and. Supplies Group. 
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RELATED DIGITAL DOCUMENTATION 

Item Document 

Number Number Description 

13 EK-VT125-UG VT125 User Guide - This document 

describes the installation, operation, 
and programming of the VT125 
terminal. This document is shipped with 
the terminal. 

1 3 EK- VT 1 00- J 1 VT 100 Series Pocket Service Guide - 

This document describes procedures 
used to troubleshoot and repair the 
VT125 terminal to the module level 

(fiplH ronla^oahlo unit^ 

13 EK-VT100-TM 

^/N/Mimer>+ i-looz-n-iKoo tKo \/T 1 OK torminql 
uuv/Uiiiciu ucovi iuv^g nic v ■ ■ C\j i&niiinai 

to a detailed block level. It provides 
troubleshooting information for the 
terminal. This document does not 
contain detailed schematic drawings. 
These drawings can be found in the 
VT125 Field Maintenance Print Set. 
That document is ordered separately. 

1 3 EK-VT 1 25-IP VT125 Video Terminal IPB - This 

document describes a detailed parts 
breakdown of the VT125 field 
replaceable units. This document does 
not contain part numbers for 
components on the printed circuit 
boards. However, components are 
listed in the the VT125 Field 
Maintenance Print Set which is ordered 
separately. 

1 3 EK-VT 1 25-RC VT 125 Programming Reference Card - 

This document provides a summary of 
the VT125 ReGIS escape and control 
sequences on a pocket size reference 
card. 

14 MP-0 1 053-00 VT 125 Field Maintenance Print Set - 

This document provides a complete set 
of electrical and mechanical schematic 
diagrams for the VT125 terminal. 
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RELATED DIGITAL DOCUMENTATION 

Item Document 

Number Number Description 

1 4 MP-0 1 052-00 VT1XX-CB and -CL Field Maintenance 

Print Set - This document provides a 
complete set of electrical schematic 
diagrams for the VT125 Graphics 
Processor Conversion kit. 

ORDERING INFORMATION 

Continental USA 

Call 800-258-1710 or mail order to: 

Digital Equipment Corporation 
PO Box CS2008 
Nashua, NH 03061 

New Hampshire 

Call 603-884-6660 or mail order to: 

Digital Equipment Corporation 
PO Box CS2008 
Nashua, NH 03061 

Alaska or Hawaii 

Call 408-734-4915 or mail order to: 

Digital Equipment Corporation 
632 Caribbean Drive 
Sunnyvale, CA 94086 

Canada 

Call 800-267-6146 or mail order to: 

Digital Equipment Corporation 

PO Box 1 3000 

Kanata, Ontario 

Canada K2K 2A6 

Att: ASG Business Manager 

Telex: 610-562-8732 
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SPECIFICATIONS 



GENERAL 

This apppendix lists the specifications of the VT125 terminal and provides 
X-ray emission statements, loopback connector wiring, and a list of re- 
lated documentation not provided by DIGITAL. 

VT125 SPECIFICATIONS 



Dimensions 




Monitor 




Height 


36.83 cm (14.5 in) 


Width 


45.72 cm (18 in) 


Depth 


36.20 cm (14.25 in) 


Keyboard 




Height 


8.89 cm (3.5 in) 


Width 


45.72 cm (18 in) 


Depth 


20.32 cm (8 in) 


Minimum table depth 


51.4 cm (20.25 in) 


Weight 




Monitor 


14.6 kg (32.2 lb) 


Keyboard 


2.0 kg (4.5 lb) 


Shipping weight 


19.6 kg (43.2 lb) 


Environment 




Operating 




Temperature 


10° to 40° C 




(50° to 104° F) 


Relative Humidity 


10 to 90 percent 


Maximum wet bulb 


28° C (82° F) 


Minimim dew point 


2° C (36° F) 


Altitude 


2.4 km (8000 ft) 
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Nonoperating 
Temperature 

Relative Humidity 
Altitude 

Power 

Line voltage 



Line frequency 
current 



Input power 

Current limiting 

Power cord 

Power cord 
receptacle 

Display 

Cathode ray tube 

Format 



Character 
Character size 



Active display size 
Character set 



Cursor type 



-40° to 66° C 
(-40° to 151° F) 
to 95 percent 
9.1 km (30,000 ft) 



99-128 V rms single-phase, 2 wire 
198-256 V rms single-phase, 2 wire 
(selected by switch) 

47 Hz-63 Hz 

2.20 A rms maximum at 120 Vrms 

1 . 10 A rms maximum at 240 Vrms 

150 Wrms or 250 VA apparent 

3.0 A fast blow fuse 

Detachable, 3-conductor grounded 

EIA specified CEE22-6A 



12 inch diagonal measure, 
P4 phosphor 

24 lines X 80 characters or 14 lines 
X 132 characters (selected from 
keyboard or computer) 
(24 X 132 with Advanced Video Option) 

7X10 dot matrix with descenders 

80-column mode 
3.35 mm X 2.0 mm 
(0.132 in X 0.078 in) 
132-column mode 
3.35 mm X 1.3 mm 
(0.132 in X 0.051 in) 

202 mm X 115 mm (8 in X 4.5 in) 

ASCII and UK displays 96 characters 
(with upper- and lowercase, numeric 
and punctuation), 32-character 
special graphics set 

Blinking block character or blinking 
underline (selected from keyboard) 
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Keyboard 

General 



Key layout 



Auxiliary keyboard 



Visual indicators 



83-key detachable unit with a 1.9 m 
(6 ft) coiled cord attached 

65-keys arranged similar to standard 
typewriter with 18-key auxiliary 
keypad 

18 keys with period, comma, minus, 
enter, and four general purpose 
function keys 

Seven: ON LINE, LOCAL, KBD LOCKED, 
and four programmable 

nuuiuic rvoyisiiorv \\j\ caon ncyduuixc 

(selectable from keyboard) 



:i_ Cnaracier 
received, and sounds eight 
characters from right margin 
(selected from keyboard) 

Multiple bell sounds on error in 
SET-UP save or recall operation 



Communication 

Type 

Speeds 



Code 

Character format 
Character size 
Parity 



Buffer overflow 
prevention 



Full-duplex EIA 

50, 75, 1 10 (two stop bits), 134.5, 
150, 200, 300, 600, 1200, 1800, 
2000, 2400, 3600, 4800, 9600, 
19,200 baud (selected from 
keyboard) 

ASCII (ISO 646 and CCITT Alphabet 5) 

Asynchronous 

7 or 8 bits (selected from keyboard) 

Even, odd or none (selected from 
keyboard) 

Automatic generation of XON and 

XOFF control 

(VT125 Graphics Terminal requires 

XON /XOFF support in its host computer.) 
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Composite video The composite video output provides 

output (J9) RS 1 70 output with the following nominal 

characteristics (Figure A-1). 

Output impedance = 75 ohms, dc coupled 
SYNC level = OV 

Black level = approximately 0.3 V when 
loaded with 75 ohms 

White level = approximately 1.0 V with 
a 75 ohm load 

Composite sync waveform meets EIA RS170 
standards. 

Vertical interval is six equalizing 
pulses, six vertical sync pulses, and 
six more equalizing pulses. Timing is 
as follows: 

Equalizing pulse width 

2.33 jus ± 50 ns 
Vertical pulse width 

27.28 us ± 200 ns 
Horizontal pulse width 

4.71 us ± 50 ns 
Horizontal blank width 

1 1.84 jis ± 50 ns/80 column mode 

12.34 us ± 50 ns/ 132 column mode 
Front porch 

1.54 /is ± 50 ns 

COLOR VIDEO OUTPUTS 

Each of the color outputs is a dc-coupled analog signal with an output im- 
pedance of 75 ohms and a level ranging from to 1 volt when loaded with 
75 ohms. No sync is available on the color outputs. 

VIDEO INPUT 

An analog signal applied to the video input will be ORed with the internal 
video signal, so the beam intensity at any point on the screen will corre- 
spond to the intensity of that signal. This tends to make the beam brighter 
at that point. A video signal on this input affects only the internal screen 
and does not appear on the composite video output. This input has the 
following nominal characteristics. 

1. Input impedance = 75 ohms, dc-coupled 

2. Black level = V 

3. White level = 1.0 V 

4. Maximum continuous input = ±2.0 V 
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EVEN FIELD: 



LAST DISPLAYED SCAN OF 
PREVIOUS FIELD 



1.0 V — I 




VERTICAL BLANKING INTERVAL 



60 Hz NON-INT = 22 SCANS 
60 Hz INT =22 SCANS 

50 Hz NON-INT = 75 SCANS 
50 Hz INT =74 SCANS 



60HzNON-INT=2SCANS 
60 Hz INT =2 SCANS 

50 Hz NON-INT= 25 SCANS 
50 Hz INT =24 SCANS 



v ifTT^TTTinrrinJLJLiMJimnrTinnriru 



FIRST OF 240 DISPLAYED 
SCANS IN EVEN FIELD 



nru 



TIME 



ODD FIELD: 

LAST DISPLAYED SCAN OF 
EVEN FIELD \ /A 



1.0 V 



i n 



h 



V\ 



START OF 
EVEN FIELD 



VERTICAL BLANKING INTERVAL 




TIME 



f60 Hz INT = 23 SCANS 1 
"^50 Hz INT = 75 SCANS J 



T60H 
|50H 



z INT = 2.5 SCANS 
Hz INT = 24.5 SCANS 



virT^nnmnriTiiiJiJLiJLFirTimr 



ODD FIELD 



IT*TT 



H PERIOD = 63.56 ms ± .01% 



FIRST OF 240 DISPLAYED 
SCANS IN ODD FIELD 

nnn r~ 
njjnj 

\T\1 U U 



BRIGHT = 1.00 V- 

NORMAL = .79 V- 

DIM = .64 V- 



BLACK = .29 V-+-- 



SYNC = 0.00-*- 
FRONT PORCH = 1.54 fis ± 50 ns 



H 



H SYNC = 4.71 ms ± 50 ns -» 



H BLAN 



kT 11 - 1 

|J2.: 



.84 /is ± 50 ns / 80 COLUMN 
34 us ± 50 ns / 1 32 COLUMN 



- H PERIOD = 63.56 us ± .01% 

NOTES: 

IN NON-INTERLACED OPERATION THE 
EVEN FIELD IS REPEATED CONTIN- 
UOUSLY. AND THE ODD FIELD IS NOT 
USED. 

IN THE INTERLACED OPERATION THE 
EVEN FIELD ALTERNATES WITH THE ODD 
FIELD. 

ALL FIELDS CONTAIN 240 DISPLAYED 
SCANS. 



-#" 



U 7T IT" 

EQ = 2.33 us ± 50 ns -*| (♦- 
*-H PERIOD = 63.56 ms ± .01% 



J] n_ 



A h 



27.28 ms 
± 200 ns 



Figure A- 1 Composite Video Output 



256 APPENDICES 



The external video source must be synchronized to the VT125; it may do 
this by referencing the composite sync on the composite video output. 
This means that the VT125 video input will not synchronize with any com- 
posite video source. 

X-Ray Emission Data 

The following information relates to X-ray emission. 



Rated anode voltage 
Dose rate 
Compliance with 



12 kV (fixed) 

Less than 1.43 pA/kg (20 uR/h)* 

• Paragraph 5, clause 2 of German 
X-Ray ordinance (1973) 

• CSA22.2no. 154-1975 
Paragraph 4.1.4 

• VDE 0804/5.72, Paragraph 23 

• VDE 0730 part 2P/6.76, Paragraph 33 

• VDE 0860 part 1 / 1 1 .76, Paragraph 6 

• IEC 65 public 1/1972, Paragraph 6 

• CSA no. 65 

• UL 478 

• EMCA 57 

Workstation exposure Does not expose the operator to dangerous 

X-ray radiation 

LOOPBACK CONNECTOR WIRING 

The following describes wiring of the loopback connector. 



From 



To 



EIA 




Pin 2 


Pins 3 and 15 


Pin 4 


Pins 5 and 8 


Pin 20 


Pins 6 and 22 


Pin 19 


Pins 12 and 17 


20 mA 




Pin 1 


Pin 3 


Pin 2 


Pin 7 


Pin 5 


Pin 8 



RELATED DOCUMENTATION 

ANSI specifications can be ordered from the following addresss. 

Sales Department 

American National Standards Institute 

1430 Broadway 

New York, NY 10018 



'Measured at a distance of 5 cm (1/96 in) at any accessible point from the outer surface. 
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EIA specifications can be ordered from the following address. 

Electronic Industries Association 
Engineering Department 
2001 Eye Street NW 
Washington, DC 20006 

International standards can be ordered from the following address. 

CCITT 

UN Book Store 

United Nations Building 

New York, NY 10017 
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SET-UP B SUMMARY 



GENERAL 

This appendix provides a summary of the VT125 terminal SET-UP fea- 
tures. Table B-1 lists the SET-UP features. Figure B-1 shows the screen 
displays. Figure B=2 is a summary of the SET-UP B features. 

Table B-1 SET-UP Feature Types 
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^^^^^^^ftpif^SiliiBSi^ip 


X 


^S^^ii^ftlfciEiisISii^Mi^iis 


:: " : """"x 


:|Sliii|lii;llll3^ 


.':■".'.'... '. : "";:.x 
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SET-UP A 

TO EXIT PRESS "SET-UP" 



| T T T T T T T T T 

!?345678M (HgSEffim 234K7890 frmmii: i?34567890 ^^ 



SET-UP B 

TO EXIT PRESS "SET-UP" 



1 BHJ 2 W 3 H * M 5 H T SPEED WOO R SPEED 9600 



Figure B- 1 SET-UP Displays 
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• AUTO REPEAT 



JUMP 
SMOOTH 
= OFF 



ff 



-screen/° 
-cursor/ ° 



= DARK BACKGRND 
= LIGHT BACKGRND 



' I I I I I H 
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MARGIN BELL 



AUTO XON XOFF 



<?: 



VT52 
ANSI ' 



J 3 L 



/ = U.S. 
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- AUTO WRAP , 



{;:■ 

FEED/ /0 = ( 
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. LINE I 
NEW I 



j n 



PARITY SENSE 



BITS PER CHAR 



/ 0= O 
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/ = 7 E 
^1=8! 

/ = 9 
\ 1 = 9 



-RESERVED = 



AUX PORT BITS J =7 BITS 
"PER CHAR. \ 1 =8 BITS 



roo 

I AUX PORT I 01 
I SPEED 1 10 



' 00 = 300 

AUX PORT J 01 = 1200 

' SPEED 1 10= 2400 

I. 11 =9600 
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Figure B-2 SET-UP B Summary 



TRANSMITTED 
CHARACTER SUMMARY 
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GENERAL 

This appendix lists the character codes generated by the VT125 terminal. 

STAUnADn l/CVC 
■ HivuHnu rvc i o 

Figure C-1 shows the codes generated by the standard keys. 

FUNCTION KEYS 

Figure C-2 shows the control codes generated by the function keys. For 
the shaded keys, CTRL does not need to be pressed in order to generate 
the control character. Table C-1 lists the control codes generated. 
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OCTAL CODES GENERATED BY KEYBOARD 






















(SHIFTED CODES SHOWN ABOVE KEYCAP LEGENDS 
















UNSHIFTED CODES SHOWN BELOW KEYCAP LEGENDS) 
















041 


100 


043 


044 


045 


136 


046 


052 


050 


051 


137 


153 


176 










1 ! 


2fe 


3# 


4$ 


5% 


6 a 


7& 


8 ' 


9! 


0) 





= + 


\ - 










061 


062 


063 


064 


065 


066 


067 


070 


071 


060 


055 


075 


140 










121 


127 


105 


122 


124 


131 


125 


111 


117 


120 


173 


175 












Q 


W 


E 


R 


T 


Y 


U 


I 





P 


If 


II 












161 


167 


145 


162 


164 


171 


165 


151 


157 


160 


133 


135 










CAPS 
LOCK 


101 


123 


104 


106 


107 


110 


112 


113 


114 


072 


042 






174 






A 


S 


D 


F 


G 


H 


J 


K 


L 








M 






141 


163 


144 


146 


147 


150 


152 


153 


154 


073 


047 




134 
















132 


130 


103 


126 


102 


116 


115 


074 


076 


077 










SHIFT 


Z 


X 


C 


V 


B 


N 


M 


. < 


> 


/? 


SHIFT 










172 


170 


143 


166 


142 


156 


155 


054 


056 


057 










040 








SPACE - 
















040 















Figure C- 1 Standard Key Codes 













MNEMONICS SHOWN ABOVE KEYCAP LEGENDS 
OCTAL CODES SHOWN BELOW KEYCAP LEGENDS 






















ESC || | 

ESC 

033 |! | 




^Q 






UlZ 










RS 

\ ~ 
036 


BS 

BACK 
SPACE 
010 


BREAK 




HT 
TAB 
011 


XON 

Q 
021 


ETB 
W 
027 


ENQ 

E 
005 


DC2 

R 
022 


DC4 

T 
024 


EM 

Y 

031 


NAK 

U 
025 


HT 

I 

011 


SI || DLE 

OP 

017 || 020 


ESC 

l( 
033 


GS 

II 
035 




DEL 

DELETE 

177 




CTRL 


II SOH ] | XOFF 1 1 EOT || ACK || BEL || BS 
II A || S ll D || F || G j| H 
|j 001 jj 023 || 004 j | 006 j| 007 jj 010 


I LF || VT || FF || || 
I J ll K || L || ■ || ' 
I 012 || 013 || 014 || || 


-II. 

II 


CR 

ETURN 

015 


FS 
I \| 
I 034 












a-7419 






SUB 

Z 
032 


CAN 

X 
030 


ETX 

C 
003 


SYN 

V 
026 


STX 

B 
002 


SO 

N 

016 


CR 

M 

015 


< 


> 


US 
/ ? 
037 




LF 

LINE 
FEED 

012 














NUL 
000 















Figure C-2 Function Key Control Codes 
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Table C-1 Control Codes Generated 







Code 






Control 


Character 


(Octal) 


Key Pressed 


Dedicated 


Character 


Mnemonic 


Sent 


with CTRL 

Space Bar 


Key 


isfisiisp^ 


NUL 


000 




Start of heading 


SOH 


001 


: -Mmx§mmx 




Start of text 


STX 


002 


B 




End of text 


ETX 


003 


^MMMMmM 




End of transmission 


EOT 


004 


D 




Enquire 


ENQ 


005 


!3llSlsBi!lSlllllSS:llillSlSll:l:ilS3S 




Acknowledge 


ACK 


006 


limM:M:tM:i 




Bell 


BEL 


007 


G 




Backspace 


BS 


010 


W&0m^A-yM 


BACK SPACE 


Horizontal tabulation 


HT 


011 


lllllSSllSlll!llSl:lllilllSlllllllll:IS 


TAB 


Line feed 


LF 


012 


SliiSiEiBSS 


LINE FEED 


Vertical tab 


VT 


013 


llllSlHIiiilSS;:Slllill:lll ;; llllll^Sl 




Form feed 


FF 


014 


(IIJjjIllllllllllJlllljIIIIIIIIII 




$f^i^ 


rf"«n 


J-fc-4 T- 


IL k 


r»i — ri ir->M /i-m-ti-i->\+ 


carriage return 


on 


UIJ 


IVI 


r»L_ i unm \i_in i i_riy 


Carriage return line feed 


CR LF 


015 01? 




RETURN (ENTER)* 


Shift out 


SO 


016 


N 


^i^jiii^ 


Shift in 


SI 


017 







Data link escape 


DLE 


020 


W&u: :■■■' ;: ; /v^ : ' r - 




Device control 1 


DC1 (XON) 


021 


Q 




Device control 2 


DC2 


022 


R 




Device control 3 


DC3 (XOFF) 


023 


■■;;:. £■;'■ " ■■■;;■: 




Device control 4 


DC4 


024 


: J; :T;;0 :: '^.: '■'.-.:, ■';.■"'.. 




Negative acknowledge 


NAK 


025 


::--u -■'.:■ . 




Synchronous idle 


SYN 


026 


■: ; ^,;^, ; ;f.: : ,:; ::i ::;, : ,::: ; 




End of transmission block 


ETB 


027 


: : : ' : '#: : -; : V : : : ': ; - : -'';. 




Cancel previous word or character 


CAN 


030 


: ; "' ; ''X ; ::;:-- v ; ::r!; : ::; : J ' :i - : .-.':'' 




End of medium 


EM 


031 


: : i.b;Y; ■■:■/ ■■:■ :; ■ 




Substitute 


SUB 


032 


.:=:-=wZ-. : :. :: ;".--.-- - : 




:^r^^g^r^;;; ^:[;^"; : !'j:-;;: ; : ; V ; ;;r- ; 


: ';^E§C::r-- ::: :-: 


033 


-.H:---.-\ 




File separator 


FS 


034 


^■f..m: : u^^^ 




Group separator 


GS 


035 


]•■ -\ 




Record separator 


:-jSIB--^' : - : ■■■'■■■'■■ V 


036 


i liS^l^iPB8iffSI 




jiMt^p^to'i:^-: ■'.:;. 


US 


;;-;037 ■:;■;■•■;, 


iS^^ttHiiiSiii 




I^B^^^^^^IiSffiSSii^H^Hiis 


-,-0£- ;■■■"■-■ 


-■■' \T7, ■"■'■■ 




DELETE 



* The RETURN character code can be changed by the line feed/new line feature. 
LF); Aisc%de pending oh the keypad mode selected, RETURN and ENTER may 

:|3§lljll^ 



PROGRAMMING 
SUMMARY 



GENERAL 

This appendix provides a summary of the VT125 escape and control se- 
quences. 



D 
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EK-VT125-RC-001 



VT125 PROGRAMMING 
REFERENCE CARD 



CONTROL CHARACTERS RECEIVED 



Name 

Null NUL 

Enquire ENQ 

Bell BEL 

Backspace BS 



Horizontal HT 

Tab 



Line Feed LF 



Vertical 
Tab 



Shift Out 



Shift In 



Device 
Control 1 



Character Octal 

Mnemonic Code 



VT 



Form Feed FF 

Carriage CR 

Return 



SO 



DC1 



000 

005 

007 
010 

011 

012 

013 

014 
015 

016 
017 
021 



Function 

Ignored when received and 
used as a fill character. 

Transmits the answerback 
message. 

Generates a bell tone. 

Moves the cursor to the left 
one character position. 

Moves the cursor to the 
next tab stop. 

Causes a line feed or a new 
line operation. (Refer to 
Linefeed/ New Line mode.) 

Processed as LF. 



Processed as LF. 

Moves the cursor to left 
margin on the current line. 

Selects the G1 character 
set, as designated by a 
Select Character Set 
sequence. 

Selects the GO character 
set, as designated by a 
Select Character Set 
sequence. 

Processed as XON. Causes 
the terminal to continue 
transmitting characters. 





Character 


Octal 




Name 


Mnemonic 


Code 


Function 


Device 


DC3 


023 


Processed as XOFF. Causes 


Control 3 






terminal to stop transmit- 
ting all characters except 
XOFF and XON. 



Cancel 



Substitute 



Escape 



CAN 



SUB 



ESC 



030 



032 



033 



Delete DEL 177 

ANSI COMPATIBLE SEQUENCES 



If received during an 
escape or control se- 
quence, the sequence is 
cancelled and substitution 
character ($) is displayed. 

Processed as CAN. 

Processed as a sequence 
introducer. 

Ignored when received. 



Set Mode 








Name 


Mnemonic 


Mode 


Sequence 


Line feed/new line 


LMN 


New line 


ESC [ 20 h 


Cursor key 


DECCKM 


Application 


ESC [ ? 1 h 


ANSI/VT52 


DECANM 


ANSI 


N/A 


Column 


DECCOLM 


1 32 column 


ESC [ ? 3 h 


Scrolling 


DECSCLM 


Smooth 


ESC [ ? 4 h 


Screen 


DECSCNM 


Reverse 


ESC [ ? 5 h 


Origin 


DECOM 


Relative 


ESC [ ? 6 h 


Auto wrap 


DECAWM 


On 


ESC [ ? 7 h 


Auto repeat 


DECARM 


On 


ESC [ ? 8 h 


Reset Mode 








Name 


Mnemonic 


Mode 


Sequence* 


Line feed/new line 


LMN 


Line feed 


ESC [ 20 I 


Cursor key 


DECCKM 


Cursor 


ESC [ ? 1 I 


ANSI/VT52 


DECANM 


VT52 


ESC [ ? 2 I 


Column 


DECCOLM 


80 column 


ESC [ ? 3 I 


Scrolling 


DECSCLM 


Jump 


ESC [ ? 4 I 


Screen 


DECSCNM 


Normal 


ESC [ ? 5 I 


Origin 


DECOM 


Absolute 


ESC [ ? 6 I 


Auto wrap 


DECAWM 


Off 


ESC [ ? 7 I 


Auto repeat 


DECARM 


Off 


ESC [ ? 8 I 



The last character of each sequence is lowercase L (1 54 8 ) 
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Cursor Key Codes Generated 







ANSI Codes 


VT52I 


Cursor Key 


Reset 


Set 




(Arrow) 


(Cursor) 


(Application) 




Up 


ESC[ A 


ESC A 


ESC A 


Down 


ESC[ B 


ESC B 


ESC B 


Right 


ESC [ C 


ESC C 


ESC C 


Left 


ESC [ D 


ESC D 


ESC D 



Keypad Character Selection 
Name Mnemonic 

Alternate 



DECKPAM 



Sequence 

ESC = 

ESC > 



Keypad Codes Generated 





ANSI Mode 


VT52 Mode 




Numeric 


Alternate 


Numeric 


Alternate 




Keypad 


Keypad 


Keypad 


Keypad 


Key 


Mode 


Mode 


Mode 


Mode 



1 


1 


ESo p 
ESC q 



1 


ESC? p 
ESC? q 


2 


2 


ESC Or 


2 


ESC? r 


3 


3 


ESC s 


3 


ESC? s 


4 


4 


ESC t 


4 


ESC? t 


5 


5 


ESC u 


5 


ESC? u 


6 


6 


ESC v 


6 


ESC? v 


7 


7 


ESC w 


7 


ESC? w 


8 


8 


ESC x 


8 


ESC? x 


9 


9 


ESC Oy 


9 


ESC? y 


— (minus) 


— (minus) 


ESC m 


— (minus)t 


ESC? mt 


, (comma) 


, (comma) 


ESC I* 


, (comma)t 


ESC? I*t 


. (period) 


. (period) 


ESC n 


. (period) 


ESC? n 


ENTER t 


CR orCRLF 


ESC M 


CR or CRLF 


ESC? M 


PF1 


ESC P 


ESC P 


ESC P 


ESC? P 


PF2 


ESC Q 


ESC Q 


ESC Q 


ESC? Q 


PF3 


ESC R 


ESC R 


ESC R 


ESC? R 


PF4 


ESC S 


ESC S 


ESC St 


ESC? St 



* The last character of the sequence is lowercase L (154 8 ) 

t These sequences were not available in the VT52. Do not use the 

PF4, "— " (minus), or"," (comma) keys with VT52 software. 
t Line feed/new line off causes ENTER to generate CR (01 5 8 ). On 

causes ENTER to generate CRLF (01 5 8 01 2 8 ). 



Select Character Sets SCS 

Character Set 

United Kingdom (UK) 
United States (USASCI I) 
Special characters 
and line drawing set 
Alternate character ROM 
Alternate character ROM - 
special characters 

Name 

Single Shift 2 

Single character shift 

to G2 (ASCii) 
Single Shift 3 

Single character shift 

to G3 (ASCII) 



GO Designator G1 Designator 



ESC ( A 
ESC( B 
ESC( 

ESC( 1 
ESC( 2 



Mnemonic 



ESC) A 
ESC ) B 
ESC) 

ESC) 1 
ESC) 2 



Sequence 



SS2 



SS3 



ESC N 



ESC O 



NOTE: The VT125 generates the following control characters 
differently from previous DIGITAL terminals. 



Code 


VT125 Keys 


Previous 1 


NUL 


CTRL— Space bar 


CTRL-@ 


RS 


CTRL- ~ 


CTRL- * 


US 


CTRL-? 


CTRL-_ 



Character Attributes 



Name 



Mnemonic 



Select Graphic Rendition SGR 

No attributes _ 

No attributes - 

Select bold attribute _ 

Select underline attribute — 

Select blink attribute — 

Select reverse video — 
attribute 



Sequence 



ESC [ m 
ESC [ m 
ESC [ 1 m 
ESC [ 4 m 
ESC [ 5 m 
ESC f 7 m 



NOTE: Without advance video option (AVO), only underline or reverse 
attribute is available. 
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US/ UK Character Set 



"' . 


■s 


°° D 


1 




° . 


° , 






' „ 


' , 


BITS 







2 


3 


4 


5 


6 


7 


oooo 


• 


NUL ° 






sp i S 


™ 


@ ,00 


P 


» 


:,. 


P .'" 








pci 




! !J 


1 JJ 


a '™ 





:; 


" :'•' 


q ;°i 


,0,0 


' 




l:» 


" :i 


2 : % 


B 


? 


R 


? 


b ! '« 




.. . . 


> 




DC3 : > 3 


/E 23 


3 " 


c 




S 


s 


c '^ 


» r, s 


.. .. 






:S 


* X 


4 r. 


D 


s 


T 


E 


d ! ™ 


t ™ 


» , o , 


* 


ENO ,'' 


fs 


\ « 


5 « 


E 




U 


5 


e ! M5 


" m 


.,..,. 






* a 


6 " 


F '" 


v 


i 


1 


,« 


» 


'" 


„.,,!, 


BEL ; 


" 


' i 


7 6 ' 


G ,0, 


w 


,: 


g 


:« 


w 


ng 




BS 1 '° 


CAM ; 


< ; » 


8 i * 


R j,,0 


X ; 


: 


h ; ;* 


* 


|™ 




HT ! ',' 


i» 


) ;; 


9 ■ ;; 


I ','j 


Y 


s 




» !i! 




lf i ;; 


SUB jj 


* : S7 


: i 


J 


« 


Z 


2 


1 ' ,06 


Z ' ! 7 7 


, o, , |„ 


y T 13 


ESC 33 


* I " 


; 5 


K 


4B 


C 




k 




{ '-2 


•' = »!" 


ff ;; 


i 


■ H 


< « 


L 


'if 


\ 


S 


1 


;« 


i ; ;;: 


• ■ o . 


cr ;j 


i 






m ■;; 


] 




m 




> 


; i 






so ;; 






> * 


N "J 


A 


* 


n 


'f* 


~ 


; i 


, . , , 


' s 


si ; !J 


?; 


/ " 


? £ 


o ; ';,' 


- 


* 


° 


e" 


DEL 


■',: 



KEY 



Special Characters and Line Drawing Set 



B ' B 


BS 


°-o 


V 


° . 












BITS 





1 


2 


3 


4 


5 


6 


7 


0000 


» 


NUL ° 




I 


SP 


M 


o ! % 


@ 


w 


p ! '2 


♦ % 


- ;j; 






; 


DC1 




... 


M 


1 

2 


• 


A 


',°6 


Q ! '11 


1 


'» 


■^-4 




■ 


' 




I 


i 


B 


i 


R V'H 


If 


00 , , 


' 


3 


DC3 ! !3 


# 


i 


3 f, 


C 


103 


s '^ 


s 


'S 


'" 




' 


4 


'3 


$ : J 


4 " 


D 


'S 


t 'j; 


\ 


:» 


1- :t: 


» , » , 


5 


ENQ I 


'£ 


% * 


5 J* 


E 


s 


U 'J 


V 




i ■:« 




• 








* S 


6 u 


F 


'So 


V 


« 





iS 


L j;« 


, , , 


' 


BEL 


; 


■jj 


' ill 


7 


it 


G 




w 


'i: 


t 


:^ 


T ; ■,, 


,000 


" 


BS 




CAN ' ; 


< I 


8 


i 


H 


';j 


X 


5 


N : '50 


i |;s 


, .0 , 


' 


HT 


; 


3 


> : .; 


9 | ;; 


i | ';, 


Y 


5 


1 
J 




'« 


,0,0 


,. 


LF 


A 


SUB 3 ^ 


* « 


: i 


-i ",'. 


z '^' 


i 








vt ; a 


ESC f y 


* ! « 


; i 


K ,,3 


c '," 


1 : '" 


* ' ; q 


, , 


" 


ff ; ;; 




' \l 


< 60 


l : '; 6 * 


\ '* 


r j 'S 


* :;: 


, ,. , 


" 


cr ;» 








m ",; 


] '," 


L .i 


£ ;« 




, 


so ;; 




' ;i 


> £ 


n '; e s 


A '2 


f , :^ 


■ \i 


, , , , 


"> 


si :; 


I 


/ ' V- 


? 63 


o ! ';,' 


BLANK. k 


VAN I ^ \f 


DEL ';', 



KEY 
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Scrolling Region 

Name Mnemonic 

Set top and bottom margins DECSTBM 

Cursor Movement Commands 

Name 



Cursor up 

Cursor down 

Cursor forward (right) 

Cursor backward (left) 

Cursor position 

Cursor position (home) 

Horizontal and vertical position 

Horizontal and vertical position 

(home) 

Index 

Reverse index 

Next line 

Save cursor (and attributes) 

Restore cursor (and attributes) 



Tab Stops 



Line Attributes 



Name 



Double-height top half 
Double-height bottom half 
Single-width single-height 
Double-width single-height 



DECDHL 
DECDHL 
DECSWL 
DECDWL 



Sequence 

ESC [ Pt ; Pb r 



Erasing 
Name 



Mnemonic Sequence 



Mnemonic 


Sequence 


CUU 


ESC [ Pn A 


CUD 


ESC [ Pn B 


CUF 


ESC [ Pn C 


CUB 


ESC [ Pn D 


CUP 


ESC f PI ; Pc H 


CUP 


ESC[ H 


HVP 


ESC [ PI ; Pc f 


HVP 


ESC[ f 


IND 


ESC D 


Rl 


ESC M 


NEL 


ESC E 


DECSC 


ESC 7 


DECRC 


ESC 8 



Name 




Mnemonic 


Sequence 


Horizontal tab set 




HTS 


ESC H 


(at current column) 








Tabulation clear 




TBC 


ESC[ g 


(at current column) 








Tabulation clear 




TBC 


ESC [ g 


(at current column) 








Tabulation clear (all ta 


ibs) 


TBC 


ESC [ 3 g 



Mnemonic Sequence 



ESC # 3 
ESC # 4 
ESC # 5 
ESC # 6 



Erase in line EL 

Cursor to end of line - 

Cursor to end of line — 

Beginning of line to cursor - 

Entire line containing cursor - 

Erase in display ED 

Cursor to end of screen - 

Cursor to end of screen — 

Beginning of screen to cursor - 

Entire screen — 



WIIIIIIUIIIl>ailUII OII« \JIH|/inv« ■ mv*vw —~J — 

Name Mnemonic Sequence 



ESC[ 


K 


ESC[ 


K 


ESC f 


1 K 


ESC[ 


2 K 


ESC[ 


J 


ESC [ 


KJ J 


ESC[ 


1 J 


ESCf 


2 J 



Device control string DCS 

Enter ReGIS at previous - 

command level 
Enter ReGIS at highest 
command level 

Enter ReGIS at previous - 

command level with 
commands to screen 
Enter ReGIS at highest 
command level with 
commands to screen 
Enter DECwriter graphics - 

Enter VT1 05 emulator - 

String terminator ST 

Exit graphics - 

Media copy MC 

Turn off computer to auxiliary - 
port 

Turn on computer to auxiliary — 
port 

Turn off computer to screen - 
Turn on computer to screen — 
Select auxiliary port for - 

ReGIS hardcopy output 
Select computer port for — 

ReGIS hardcopy output 



ESC P p 
ESC P 1 p 
ESC P 2 p 

ESC P 3 p 



ESC Pq 
ESC P t 



ESC \ 

ESC [ 4 i 

ESC [ 5 i 

ESC [ 6 i 
ESC [ 7 i 
ESC [ ? i 

ESC ( ? 2 i 
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Reports 

Name 

Device status report 
(request status of VT125) 
Response: 

Terminal OK 

Terminal not OK 

Device status report 
(request cursor position) 
Cursor position report 



Mnemonic Sequence 



DSR 



DSR 
DSR 



DSR 
CPR 



Device attributes (what are you) DA 
Device attributes (what are you) DA 
Identify terminal (what are you) DECID 

NOTE: ESC Z is not recommended. 

Device attributes DA 

response: VT1 25 



ESC | 


; 5 n 




ESC | 


n 




ESC f 3 n 




ESC[ 


6 n 




ESC[ 


PI; 


Pc R 


ESCf 


c 




ESC[ 


c 




ESC Z 





See Note. 



NOTE: Format is ESC [ ? 12 ; <vt100> ; <vt125> ; <version> c 



<vt1 00> 
<vt125> 
<version> 

Resst 

Name 

Reset to initial state 



5 = r. c &VO, 7 = AVO 
1 = printer, = no printer 
Graphics firmware 



Mnemonic Sequence 

RIS ESC c 



10. 



VT100 Tests and Adjustments 

NOTE: Do not use VT100 loopback tests with the graphics processor 
installed. Loopback tests require test connector. Continuous tests end 
at failure or power-off. 



Name 



Mnemonic Sequence 



Screen alignment display 
Fill screen with "Es" 



DECALN 



ESC # 8 



Invoke confidence test DECTST - 

Power- up test - ESC [ 2 ; 1 y 

Data loopback test - ESC ( 2 ; 2 y 

Power-up and data loopback - ESC [ 2 ; 3 y 

tests 

EIA modem control loopback - ESC [ 2 ; 4 y 

test 

Power-up and EIA loopback - ESC [ 2 ; 5 y 

tests 

Data loopback and EIA - ESC [ 2 ; 6 y 

loopback tests 

Power- up, data loopback, - ESC [ 2 ; 7 y 

and EIA loopback tests 

Repeat power- up test - ESC [ 2 ; 9 y 

continuously 

Repeat data loopback test - ESC [ 2 ; 10 y 

continuously 

Repeat power-up and data - ESC [ 2 ;. 1 1 y 

loopback tests continuously 

Repeat EIA test continuously - ESC [ 2 ; 1 2 y 

Repeat power-up and EIA - ESC [ 2 ; 13 y 

tests continuously 

Repeat data loopback and EIA - ESC [ 2 ; 14 y 

loopback tests continuously 

Repeat power- up, data - ESC j 2 ; 1 5 y 

loopback, and EIA loopback 

tests continuously 
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11. 



.12 



VT1 25 Tests and Adjustments 

NOTE: All tests require loopback connector. Always include power-up 
test for correct display of error indications. 



Ps y 



Name 


Mnemonic 


Sequence 


Invoke confidence test 


DECTST 


ESC [ 4 ; 1 ; Ps 


VT1 25 power-up test 


- 


Ps= 1 


VT1 25 computer port 


- 


Ps=2 


data loopback test 






VT1 25 auxiliary port 


- 


Ps=3 


data loopback test 






VT1 25 display test 


- 


Ps = 4 


\m oc ,.;,j„„ u;* ~~„ 


- 


Ps= 5 



memory test 

Repeat any selected - 
tests continuously until 
power-off or failure 

Keyboard Indicators 

Name 

Load LEDs 
AM off 
L1 on 
L2 on 
L3 on 
L4 on 

VT52 COMPATIBLE MODE 

Mode 

Enter ANSI mode 

Keypad Character Selection 

Name 

Enter alternate keypad mode 
Exit alternate keypad mode 
(numeric keypad mode) 



Ps= 9 



Mnemonic Sequence 



DECLL 



ESC [ q 
ESC [ 1 q 
ESC [ 2 q 
ESC [ 3 q 
ESC [ 4 q 



Sequence 

ESC< 

Sequence 

ESC = 
ESC> 



Character Sets 



Name 



Special graphics character set 
Select US/UK character set 
(as determined by the US/UK 
character SET-UP feature) 



Sequence 

ESC F* 
ESC G 



Same as special character and line drawing set in ANSI mode. 
Cursor Position 



Name 

Cursor up* 
Cursor down* 
Cursor right* 
Cursor left* 
Cursor to home 
Direct cursor address 
Reverse line feed 



Sequence 

ESC A 
ESC B 
ESC C 
ESC D 
ESC H 

ESC Y PI Pet 
ESC It 



* Same when sent from the terminal. 

t Line and column numbers for direct cursor address are single 

character codes whose values are the desired number plus 31 10 . 

Line and column numbers start at one. 
t The last character of the sequence is an uppercase i (1 1 1 8 ). 

Erasing 

Name 

Erase to end of line 
Erase to end of screen 

Reports 

Name 

Identify (what are you) 
Response: VT52 



Sequence 

ESC K 
ESC J 



Sequence 

ESC Z 
ESC/ Z 



NOTE: VT52 alternate keypad and numeric keypad modes are different 
from ANSI. 
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13 



14. 



ReGIS COMMAND SUMMARY 
Position Command Summary 
Command 

P I] 

[<position>] 

<pixel vector> or<pv> 

(B) 
(S) 
(E) 
(W (<temp. writing controls>)) 

Vector Command Summary 

Command 

V [] 

[<position>] 

<pixel vector> or <pv> 

(B) 
(S) 
(E) 
(W (<temp. writing controls>)) 

Curve Command Summary 

Command 

C [<position>] 



(C)[<position>] 



(A<degrees>) [<position>] 



(A<degrees>C) [<position>] 



(B) [<pos>] . . . [<pos>] (E) 

(S) [ ] [<pos>]. . . [<pos>] [ ] (E) 

(W(<temp. writing controls>)) 



Function 

Reset pattern memory. 
Move to <position>. 
Move <multiplier> pixels in 
<pv> direction. 
Save current location. 
Save dummy location. 
Move to last saved location. 
P(W(M<multiplier>)). 



Function 

Draw dot at current position. 
Draw vector to <position>. 
Draw <multiplier> pixels in 
<pv> direction. 
Save current position. 
Save dummy position. 



Function 

Circle with center at current 

position, circumference at 

<position>. 

Circle with center at 

<position>, circumference at 

current position. 

Arc with center at current 

position, starting at <position> 

for <degrees>. 

Arc with center at <position>, 

starting at current position for 

<degrees>. 

Bounded (closed) curve 

Unbounded (open) curve 



Text Command Summary 

Command 

T (S <size number>) 
(H <height>) 
[<spacing>] 

(S [<width in pixels>,<height in pixels>]) 
(M [<width pixel multiplied, <height pixel multiplied]) 
(D <direction angle>) 
(D <string tilt> S <size> D <char tilt>) 
(T <italic degrees>) 
(A <pattern set number>) 
((B) <temporary attributes block> (E)) 
(W(<temp. writing controls>)) 

Writing Controls Summary 



Command 


Function 


W (C) 


Complement 


(E) 


Erase 


(R) 


Replace 


IV) 


Overlay 


(F <foreground planes>) 


= no planes 




1 = plane 1 




2 = plane 2 




3 = planes 1 and 2 




Foreground intensity: 


(I or (D) ) 


Dark or Dark 


1 (R) ) 


Dim grey Red 


2 (G) ) 


Light grey Green 


3 (B) ) 


White Blue 


(C) ) 


Cyan 


(Y) ) 


Yellow 


(M) ) 


Magenta 


(W) ) 


White 


or 




(I (H <hue angle> 




L <lightness percent> 




S <saturation percent>)) 




(M <multiplier>) 


Pixels per <pv> 


(N1) 


Negative on 


(NO) 


Negative off 


(S1) 


Shading on 


(SO) 


Shading off 


(S [.shading reference]) 




(S 'shading character) 




(P <binary pattern>) 


Enter pattern. 


(P <pattern number>) 


Use VT1 25 pattern. 


(P (M <pattern multiplied)) 




(W<i>(P<j>,N<k>)) 


Custom writing control 
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Screen Controls Summary 

Command 

S <pixel vector> 
[<position>] 

(A [<position>] [<position>]) 
(E) 
(H [<position>] [<position>] 

(H(P[<position>])) 



Function 

Scroll. 

Display addressing. 

Erase screen. 

Hardcopy (corner positions 

optional) 

Set hardcopy offset. 



Report Command Summary 

Command 

R (L) 

(M (<keyletter>)) 
(M (=)) 

"<free>,<total>" 
(P) 



Function 

Set selected for loading. 
Contents of macrograph. 
Use of storage. 
Reply to use. 
Cursor position. 



csacKgrouna intensity: 






or (D) ) 


Dark 


or Dark 


1 


(R) ) 


Dim grey 


Red 


2 


(G) ) 


Light grey 


Green 


3 




W h ite 


Blue 




(Q ) 




Cyan 




(Y) ) 




Yellow 




(M) ) 




Magenta 




(W) ) 




White 



(I (H <hue angle> 

L <lightness percent> 
S <saturation percent>)) 

S(M<n>(<mono HLS>)(A<color HLS>)) Output mapping 



(S <scale>) 

(S (X<scale>Y<scale>)) 

(T<ticks>) 

(W (temporary writing controls) 

Macrograph 

Command 



Time delay 



Function 



@ 



:keyletter character string @; 

keyletter 



Character Cell Control Summary 

Command 

L (A<integer>) 
(A"<name>") 

"<ASCII char>" <hex pair> . . 
<hex pair>; 



Clear all macrographs. 
Define macrograph. 
Invoke macrograph. 



Summary 

Select for loading. 
Give name to set. 
Load cell. 



1st Edition, September 1981 



Copyright ® 1981 by Digital Equipment Corporation. 
All rights reserved. 



Printed in U.S.A. 



ANSI CODE EXTENSION 
TECHNIQUES 



GENERAL 

This appendix describes the ANSI code extension techniques as defined 
in ANSI standards X3.41-1974 and X3.64-1979 (ISO 2022 and 6429). (Re- 
fer to Chapter 1 1 for ANSI standards ordering information.) The descrip- 
tion is based on the functions used in the VT100 and LA120 families of 
terminals. There are many special cases and details in the specifications 
that are not described here. 

CLASSES OF CHARACTERS 

The ANSI system is based on the use of classes of characters for specific 
purposes. The classes are determined by the character position in the 
ASCII table (Figure E-1). This table and the ANSI system can work for ei- 
ther a 7-bit or an 8-bit character environment. Current terminals support 
only 7-bit characters. 

CONTROL FUNCTIONS 

Control functions are all control characters and groups of characters 
(strings) that control terminal operation but are not displayed on the 
screen. Not all control functions perform an action in every device that 
understands ANSI, but each device can understand all control functions 
and discard any that do not apply to it. Therefore, each device is said to 
perform a subset of the ANSI functions. 

ANSI COMPLIANCE 

Different devices use different subsets. Therefore, compliance with ANSI 
does not mean compatibility between devices. Compliance only means 
that a given action, if defined in the ANSI standard, is caused by the same 
control function in all devices. If an ANSI device does not perform an ac- 
tion that has a control function defined in the ANSI standard, it cannot use 
that control function for any other purpose. 
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B7 

Be 


B5 










1 



1 





1 
1 


1 




1 


1 


1 
1 




1 

1 
1 


BITS 


COLUMN 




1 


2 


3 


4 


5 


6 


7 


B4 B3 B2 B1 


ROW 








NUL 







DLE 


20 
16 
10 


SP 


40 
32 
20 


O 


60 
48 
30 


@ 


100 
64 
40 


P 


120 
80 
50 


\ 


140 
96 
60 


P 


160 
112 
70 


1 


1 


SOH 


1 
1 
1 


DC1 

(XON) 


21 
17 
11 


f 


41 
33 
21 


1 


61 
49 
31 


A 


101 
65 
41 


Q 


121 
81 
51 


a 


141 
97 
61 


q 


161 
113 

71 


10 


2 


STX 


2 
2 
2 


DC2 


22 

18 
12 


ii 


42 
34 
22 


2 


62 
50 
32 


B 


102 
66 
42 


R 


122 
82 
52 


b 


142 
98 
62 


r 


162 

114 
72 


11 


3 


ETX 


3 
3 
3 


DC3 

(XOFF) 


23 
19 
13 


# 


43 
35 
23 


3 


63 
51 
33 


C 


103 
67 
43 


S 


123 
83 
53 


c 


143 
99 
63 


s 


163 
115 
73 


10 


A 


CAT 


4 

4 
4 


DC4 


24 
20 
14 




44 
36 
24 


4 


64 
52 
34 


n 


104 
68 

44 


T 


124 
84 
54 


m 


144 
100 
64 


♦ 


164 
116 
74 


10 1 


5 


ENQ 


5 
5 
5 


NAK 


25 
21 
15 


% 


45 
37 
25 


5 


65 
53 
35 


E 


105 
69 
45 


U 


125 
85 
55 


e 


145 
101 
65 


u 


165 
117 
75 


110 


6 


ACK 


6 
6 
6 


SYN 


26 
22 
16 


& 


46 
38 
26 


6 


66 
54 
36 


F 


106 
70 
46 


V 


126 
86 
56 


f 


146 
102 
66 


V 


166 

118 

76 


111 


7 


BEL 


7 

7 
7 


ETB 


27 
23 

17 


/ 


47 
39 
27 


7 


67 
55 
37 


G 


107 

71 
47 


w 


127 
87 
57 


9 


147 
103 
67 


w 


167 

119 

77 


10 


8 


BS 


10 
8 
8 


CAN 


30 
24 
18 


( 


50 
40 
28 


8 


70 
56 
38 


H 


110 
72 
48 


X 


130 
88 
58 


h 


150 
104 
68 


X 


170 
120 
78 


10 1 


9 


HT 


11 
9 
9 


EM 


31 
25 
19 


) 


51 
41 
29 


9 


71 
57 
39 


I 


111 
73 
49 


Y 


131 
89 
59 


j 


151 
105 
69 


y 


171 
121 
79 


10 10 


10 


|_F 


12 
10 
A 


SUB 


32 
26 
1A 


* 


52 
42 
2A 


: 


72 
58 
3A 


j 


112 
74 
4A 


7 


132 
90 
5A 


j 


152 
106 
6A 


2 


172 
122 
7A 


10 11 


11 


VT 


13 
11 
B 


ESC 


33 
27 
1B 


+ 


53 
43 
2B 


5 


73 
59 
3B 


K 


113 
75 
4B 


c 


133 
91 
5B 


k 


153 
107 
6B 


{ 


173 
123 
7B 


110 


12 


FF 


14 
12 
C 


FS 


34 
28 
1C 


j 


54 
44 
2C 


< 


74 
60 
3C 


L 


114 
76 
4C 


\ 


134 
92 
5C 


1 


154 
108 
6C 


I 


174 
124 
7C 


110 1 


13 


CR 


: 3 5 

D 


GS 


35 
29 

1D 


- 


55 
45 
2D 


S 


75 
61 
3D 


M 


115 
77 
4D 


1 i 135 

J j 93 

| 5D 


m 


155 
109 
6D 


> 


175 
125 
7D 


1110 


14 


SO 


16 
14 

E 


RS 


36 
30 
IE 


■ 


56 
46 
2E 


> 


76 
62 
3E 


N 


116 
78 
4E 


A 


136 
94 
5E 


n 


156 
110 
6E 


"V 


176 
126 
7E 


1111 


15 


SI 


17 
15 

F 


US 


37 
31 
1F 


/ 


57 
47 

2F 


? 


77 
63 
3F 


O 


117 
79 
4F 


— 


137 
95 
5F 


o 


157 
111 
6F 


DEL 


177 
127 
7F 



KEY 



ASCII CHARACTER 




33 


OCTAL 


27 


DECIMAL 


1B 


HEX 



Figure E-1 ASCII Characters 
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For example, ESC c is the Reset sequence for devices meeting ANSI and 
having a remote reset function. If a device does not have this function, it 
may not use ESC c for any other purpose. ESC 7 (Save Cursor Position), 
however, is a private sequence and may be used for other purposes by 
devices from other manufacturers. But within DIGITAL each private se- 
quence is registered in an internal standard so that all DIGITAL products 
use each sequence for only one purpose. 

CONTROL CHARACTERS 

A control character is a single character which (when received by the ter- 
minal) starts, modifies, or stops a control function. The value of a control 
character is in the octal range of through 37 and 177. 

Chapter 4 of this document explains the control characters understood by 
the terminal. All other control character codes are ignored. 

This terminal can perform some actions usually caused by control charac- 
ter codes from the 8-bit ASCII environment, which this terminal does not 
understand, it does this by understanding certain combinations of 7-bit 
codes, which other sections of this appendix will explain. 

ESCAPE SEQUENCES 

The Escape or ESC character (033s) is a control character that causes 
the terminal to wait for more characters that are not in the control charac- 
ter numerical range. This character is defined by ANSI standard X3.4- 
1977 as Introducer. If the terminal receives this character, it waits for 
more characters to follow within certain numerical ranges to form an es- 
cape sequence as defined in ANSI X3.41-1974 and ANSI X3.64-1979. 

The format of an escape sequence is: 

F 

060-176 
Final 

character 

introducer (Any number of (One code) 

codes - or more) 

If following characters are in the range 040 - 057(8) (column 2), they are 
called intermediate characters. The device accepts and stores them. 

If a following character is in the range 060 - 176(8) (columns 3 to 7), it is 
a final character. The final character signals the end of an escape se- 
quence which the device then analyzes. Final characters from column 3 
are for private control functions for use in a specific device. Final charac- 
ters from columns 4-7 are for ANSI standardized control functions. 



ESC 


I. ..I 


033 


040-057 


Escape 


Intermediate 


sequence 


characters 
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Some two-character escape sequences perform the same actions as 
some 8-bit single-character control functions. The VT100 family supports 
six of these. 



ESC [ is CSI (refer to Control Sequences) 

ESC D is IND \ 

ESC E is NEL> (refer to Cursor Positioning) 

ESC M is Rl J 

ESC N is SS2 

ESC O is SS3J 



( Hrefer to Character Sets and Selection) 



The VT125 also supports ESC P, which is DCS and ESC \, which is ST 
(refer to Communication and Graphic Protocol Controls). 

The intermediate and final characters are taken together to define the 
function of the sequence. Then the device performs the action and ac- 
cepts more data. If the action defined by the escape sequence does not 
apply to the device, the device ignores the complete sequence and ac- 
cepts more data. 

Escape sequence examples (all examples have added spaces between 
characters to make them easier to read). 

ESC H = Set tab at active position 
ESG ( B = Designate GO character set as ASCI! 
ESC #6 = Double width line (VT100)(6 = DIGITAL private) 
ESC ( = Designate GO character set as DIGITAL private 
special graphics character set (0 = private) 

Example sequence: Designate GO character set as ASCII 
Select Character Set (SCS) = ESC ( B 



ESC 



Sequence 
I 

( 



Escape 

character 

Intermediate 
character 



B 



Final 
character 



033 



Escape 
character 



Octal representation 
of sequence 



050 



Intermediate 
character 



102 



Final 
character 
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CONTROL SEQUENCES 

The string ESC [ is a two-character escape sequence and represents the 
8-bit control character Control Sequence Introducer (CSI). CSI precedes 
all control sequences in the same way that the ESC introducer precedes 
all escape sequences. ESC [ allows the extended functions of the 8-bit 
control sequence environment to work in the 7-bit environment of current 
terminals. The control sequence is defined in ANSI X3. 64-1979. 

The format of a control sequence is as follows. 



CSI 


P...P 


I... I 


F 


033 133 


060-077 


040-057 


100-176 


Control 


Column 3 


Column 2 


Column 4-7 


sequence 


parameter 


intermediate 


final 


introducer 


(0 or more 


(0 or more 


(One code) 




codes) 


codes) 





A device parses this sequence witnout consiaermg lis meaning, inai is, 
characters are stored in classes only according to their range of values. 
Then, the device interprets these characters by value according to their 
classes. The intermediate and final characters are taken together to de- 
fine the function of the sequence. In the range of final characters, 100 - 
157 (columns 4-6) are reserved for standardization by ANSI, while 160 - 
176 (column 7) are reserved for private use. 

Parameters 

Parameters modify the action or interpretation of the function. The param- 
eters are from column 3 and may be any combination of the characters - 
9 (060 - 071) with each parameter separated from the others by ; (073). 
(The other characters in column 3 are : (072) which is reserved, and 
< = >? (074 - 077) which are assigned for private use and mean that the 
following parameters have a private interpretation.) Any leading zero in a 
parameter is ignored; this also applies to the parameter value 0. There- 
fore, a sequence with no parameter is the same as a sequence with a 
parameter of and both are understood as having the default value for 
that parameter in the sequence. 

A single parameter that modifies the action of a control function is called 
a numeric parameter and has the abbreviation Pn. (Example: Cursor Up, 
ESC [ Pn A, where Pn is number of lines.) A parameter that defines the 
action of a control function by selecting from a list of possible actions is 
called a selective parameter and has the abbreviation Ps. (Example: Set 
Mode, ESC [ Ps h, where Ps selects the mode to be set.) Control functions 
that have selective parameters can accept multiple parameters to allow 
several actions to be commanded with a single control function. 

A sequence with multiple parameters has several Ps separated by ; char- 
acters (Ps;Ps;Ps). This is called a parameter string. If the parameters ap- 
ply to the screen image, their abbreviations indicate this: Pt;Pb for top and 
bottom, and PI;Pc for line and column. 
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Character 077 (?) at the beginning of a parameter string means that the 
parameters are private parameters. That means the control sequence is 
standardized but the function that it controls is private, for example, set 
and reset mode control functions. Some control functions are defined to 
have a default value for a parameter. The default value is assumed when 
no parameter character is included in a sequence. 

Examples with Octal Equivalents 

ESC [ 3 g 

033 133 063 147 

The above sequence clears all tabs. 



ESC [ g 

033 133 147 

The above sequence clears all tabs at active position (default value = 0). 



ESC [ 1 6 ; 3 2 u 

033 133 061 066 073 063 062 165 

The above sequence sets tabs at columns 16, 32 (LA 120) (u = private). 



ESC [ ? 2 ; 3 h 

033 133 077 062 073 063 150 

The above sequence sets modes 2 and 3 (? = private). 



ESC [ 2 h 

033 133 062 060 150 

The above sequence sets linefeed /new line mode (parameter = 20). 



ESC [ 2 ; 1 y 

033 133 062 073 061 171 

The above sequence runs power-up self-test (VT100) (y = private). 

NOTE: There are no examples of control sequences with intermediate 
characters because current terminals do not have any control functions in 
that format. However, new software written to understand the ANSI syntax 
should be able to parse sequences with intermediate characters. Future 
DIGITAL terminal Droducts mav use intermediate characters 
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Example Sequence: Control sequence to set modes for 132 column 
mode, smooth scrolling, and reverse screen 



ESC[?3;4;5h 



Indicates private 
parameter 

ESC[ ? 3 



CSI 



Delimiters 




Parameters 



Parameter string 



Final 
character 



Indicates private 
parameter 



Delimiters — ( 



033 



133 



077 



063 



073 



064 



073 



065 



CSI 



Parameters 



Parameter string 



150 



Final 
character 



Alternate sequences that will do the same thing: 

ESC[?3hESC[?4hESC[?5h Parameters can be split into separate 

control sequences. 



ESC[?03;004;5h 



Leading zeroes are ignored. 



ERROR RECOVERY 

The ANSI standards do not define error recovery techniques for incorrect 
control functions. These errors include out of range parameters, invalid 
control functions, and control characters embedded in control functions. 
The VT100 family recovers from errors with as much correct function as 
possible rather than discard any error. For example, if the VT100 receives 
a sequence asking it to move the cursor beyond the right margin, it moves 
the cursor to the right margin. In the LA120, a command to move beyond 
the right margin is ignored and the active position stays unchanged. 
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If a control character appears within a sequence, the VT100 performs the 
function of the control character (for example, a carriage return) as if it 
had been received before the beginning of the sequence. However, CAN 
and SUB appearing in a sequence stop the processing of the sequence at 
that point. The terminal returns to regular character processing and dis- 
plays any characters remaining in the sequence. 

An unrecognizable control function is ignored. Unsupported control func- 
tions (any apparently valid sequences that are not listed in this docu- 
ment) are generally ignored but may produce unpredictable responses. 

NOTE: Some programmers have used error condition actions in a given 
terminal to get the actions they wanted. This is not a safe practice in the 
ANSI environment because there is no guarantee that different ANSI-com- 
plying terminals will handle an error the same way. Using error conditions 
would limit the transportability of code. 

CHARACTER SETS AND SELECTION 

GO, G1, CO, C1 Character Sets 

The ANSI and ISO standards provide extensions to the range of graphic 
and control character sets in a terminal, in addition to the extension of 
control functions described in the preceding section. 

A tynica! terminal transmits and receives the 7-bit ASCI! character set. 
This character set has an eight-column chart, and in it, columns and 1 
are control characters, while the rest of the set is graphics (except SP 
and DEL). SP (space) and DEL (delete) are always the same control char- 
acters with the same codes, regardless of character set and so they are 
independent of character set selection. 

The ANSI standards provide a system to allow the use of larger character 
sets in any terminal, without increasing the number of bits that the termi- 
nal must use to describe each unique character. 

Refer to Figure E-2. The left side of the figure represents the familiar 7-bit 
ASCII character set. GO and G1 are labels attached to character sets to 
indicate how the sets can be substituted. The ANSI word for this is desig- 
nate. There are escape sequences that designate character sets as ei- 
ther GO or G1. The control characters shift out (SO (016)) and shift in (SI 
(017)), when included with 7-bit ASCII data, switch the display of a termi- 
nal from one character set to the other. The ANSI word for this is invoke. 

In the VT100, any character set whose display patterns are stored in the 
terminal can become either GO or G1. SO always invokes the G1 set and 
SI invokes the GO set. Sets can be invoked or designated at any time and 
in any order. Some character sets have been internationally registered, 
while others are private for use in a given terminal. 
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COLUMN 

1 2 3 4 5 6 7 10 1112 13 14 15 16 17 



ROW 


i 




1 1 I 


i 


I 




i I I 


i 


. 




SP 


P 




DCS 




1 






GO 




C1 
SET 




G1 


2 . 




SET 




SET 


3 . 

4 _ 




£<— 


— \ 


ND 




5 _ 


CO 


7 NEL 




6 . 


SET 










7_ 












10 . 














11 . 










12_ 




\ 




ST 




13 . 












14 J 

15 _ 




M 


Rl 

, SS2 

DELSS3 




16- 
17 




N 








CO, C1 = CONTROL CHARACTER SETS 
GO, G1 = GRAPHIC CHARACTER SETS 
DCS, ST = VT125, VK100ONLY 



Fim.ro F-9 ft-Rit ASCII Chart 



ESC (A »>G0 SET 1 (UK) 

ESC(B ►GO SET 2 (ASCII) 

o ESC (0 »>G0 SET 3 (SPECIAL GRAPHICS) 

» GO SET 4 

*• GO SET n 



SO 



ESOA »»G1 SET 1 (UK) 

o ESOB *G1 SET 2 (ASCII) 

-+o- ESOO »-G1 SET 3 (SPECIAL GRAPHICS) 

o *» G1 SET 4 

*G1 SET n 



Figure E-3 Shift-Out and Shift-In Illustrations 



In the VT100, the CO control character set is normally available. There are 
escape sequences that cause the actions of single control functions of 
the C1 set on a one time basis. The ESC character followed by a final 
character from columns 4 or 5 causes the action of a control function that 
is also caused by a single 8-bit character in the C1 set. Figure E-2 shows 
how ESC [ causes the CSI function and ESC D causes the IND function 
from the C1 set. The other C1 characters that are supported in the VT100 
family of terminals are also shown. 

Figure E-3 shows a schematic representation of the Shift Out and Shift In 
concept. This figure shows how GO and G1 character sets are designated 
by escape sequences and invoked by the SO and SI characters. 



CREATING 
COMPATIBLE ReGIS 



GENERAL 

This appendix lists the differences in implementation of ReGIS between 
the VT125 and the VK100 (GIGI). Use this information to create ReGIS im- 
ages if you must use the same source on both terminals. 



COMPATIBLE ReGiS SUMMARY 

Use- 
Four colors only; use 
S(M...) if not D, B, R, G 

HLS or RGB in S(L.) and W(L.) 

S(I...,E) 

W(V/R/E),W(N...) 
W(I,C) 
S(H[0,y1][767,y2]) 

S[<0 to 767>,<0 to 51 1>] 



2000 or less characters of 
macrographs 



Rather than... 

More than four colors 

Numeric arguments to W(l...) 
andS(l...) 

S(E,L.) 

W(F...), W(W...) 

W(C) 

S(H[x1,y1][x2,y2])or 
S(H[,y1][,y2]) 

S[ ] with negative or 
overrange numbers 

More than 2000 characters of 
macrographs 
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COMMAND DIFFERENCE SUMMARY 



VT125 



VK100 



S(M...) selects color 
S(l,..) and W(L.) select one of 
the colors specified by S(M...), 
based on a closest-match algorithm 



S(L.) and W(l„.) 

explicitly select colors 



HLS color specifiers to S(M...), 
S(l...), and W(L.) specify one 
of 64 colors 



HLS specifiers select 
one of 8 colors 



O/l — \ I 1A//I_\ i I. _ _ 

ovin/ anu vvvmy aucepi values 
of to 3 for n 



sun; and W'un; accept 
values of to 7 for n 



NoS(W...) 



S(S...) controls screen 
scaling (zoom) 



S(W...) controls erase 
write operations 

NoS(S...) 



S(H[x1,y1][x2,y2]) will hardcopy 
a specified rectangle from 
x1,y1 tox2,y2 



S(H...) only uses Y 
values of range 



S(H(P[x,y])) positions the 
hardcopy device at x,y before 
performing the hardcopy 
Default value is [50,0] 

S(H...) performs scaling 
(zoom) on hardcopy if selected 



No S(H(P...)), defaults 
to [50,0] 



No scaling 



No W(l) (no argument to I) 



W(F...) selects planes to be 
written 



W(l) allows writing of 
only the foreground/ 
background plane, leaving 
the color unchanged 

NoW(F...) 



W(C) writing complements each 
plane individually, thus it may 
change the color 



W(C) writing complements 
only the foreground/ 
background plane, writing 
an explicit new color or 
leaving the color 
unchanged 
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VT125 

NoW(A...) 



No locator mode; could 
be emulated in software. 



VK100 

W(An) selects "blink" 
attribute for writing 

R(P(I...)) allows 
interactive positioning of 
a "locator" cursor, also 
accessible by a keyboard 
command 



At least 5000 characters of 
macrograph storage 

Concurrent text and graphics 
can be displayed by using 
"DCS 2 p" to enter graphics 



At least 2000 characters 
of macrograph storage 

SET-UP mode "GD" allows 
the last line of graphics 
commands to be displayed 



VSWI IVSVJ 



rroi"»+l\j vA/i+h 

I I \^l I II J Willi 



nranhirvQ 



ReGIS command parsing is 

not affected by "DCS p" and 

"ST" 

Using "DCS 1 p" will 

reset ReGIS to top comand level 

Graphics cursor cannot be disabled; 
it is present whenever the VT125 
is processing ReGIS graphics 
commands 

Hardcopy output can be 
directed to the host port 
using the "Media Copy" control 
sequence 

Hardcopy output is enclosed 

in a single "DCS q'7"ST" sequence, 

using the DECwriter control 

commands 

Hardcopy image data sent to 
the VT125 will be displayed as if 
the VT125 was a hardcopy device 



"DCSp" resets ReGIS to 
top command level 



SET-UP mode "VC" selects 
whether the graphics 
cursor is displayed 



Hardcopy output can be 
directed to the host port 
by swapping the cables 



Hardcopy output is 
enclosed in "DCS q" on a 
line-by-line basis 



Hardcopy data sent to the 
VK100 is ignored 



HLS COLOR SYSTEM 
INTHE VT125 



GENERAL 

The display port for the external color monitor is driven by a six-bit output 
map. The output map provides two bits (four levels) of intensity for each 
primary color: red, green, and blue. This section describes the general al- 
location of RGB specifiers based on HLS descriptors. 

The HI _Q HrtuKIp r»nno mnrlol fFiniiro f5-1\ ic Hi\/iHoH into cowan loyoro lino. 

arly spaced along the lightness axis. If lightness is not specified in a color 
descriptor, it defaults to 50 percent, the layer with the greatest variety of 
colors. The extreme layers (below 14 percent and above 86 percent) map 
to black and white respectively, regardless of H and S. 

Each nonextreme lightness level is divided into one to three concentric 
rings, based on the saturation parameter. If saturation is percent, then 
the color specifier must map to one of four grey levels based on the light- 
ness parameter. If saturation is not specified, it defaults to 100 percent. 

Each nongrey lightness/saturation ring is divided into from 3 to 12 seg- 
ments based on hue. Hue has no default. If not specified, then the light- 
ness parameter again defines a grey level. By these defaults, the null 
specifier maps to the medium grey level in the VT125. 

Percentage values for L and S of less than or more than 100 map to 
percent and 100 percent respectively. Hue is computed modulo 360. 

The following table summarizes the color allocations derived from the 
above rules. 
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DIAMETER IS 

PROPORTIONAL 

TO NUMBER OF HUES 

THAT CAN BE 

DISPLAYED. 



Figure G-1 HLS Double Cone Color Model 



Lightness Saturation Color Range 



Oto 14 


Any 


15 to 28 


Any >0 


29 to 42 


1 to 49 




50 to 100 


43 to 57 


1 to 33 




34 to 66 




67 to 100 



58 to 71 



1 to 49 



Black 

Three primaries and simple secondaries 

Three light primaries 

nine shades, including middle 

lightness pure primaries 

Three unsaturated secondaries 

nine shades, including less saturated 

primaries 

twelve shades, including the brightest 

pure primaries, almost brightest pure 

secondaries, and the six shades in 

between 

Three unsaturated primaries 



pure secondaries 
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Lightness Saturation Color Range 

72 to 85 1 to 49 Three very unsaturated primaries 

50 to 100 Three less than fully saturated 
secondaries 

86 to 100 Any White 

The primaries are red, green, and blue. The secondaries are yellow, cyan, 
and magenta. 

When saturation is percent or hue is unspecified, lightness values to 
24, 25 to 49, 50 to 74, and 75 to 100 map to black, dim grey, brighter 
grey, and white respectively. 



ReG IS COMMAND 
LISTING 



GENERAL 

This appendix lists the ReGIS commands used to create art for this book. 



p[200, 100] (b) [ + 15,-15] t' [200,100]' p(e) v (b) [200 , 200] (b) 

p(b) T + 10.-15] t' [200.200]' p(e) 

v[306,400] p(b) [+5] t* [300,400]* p(e) v[400,300] 

v[100,50] p(b) [-85,-10] t'[100,50]' p(e) v(e)c[+10] 
pU00,430] t(sl) n p[200,100] v (b) [200 , 200] (b) v[300,400] 
v[400,300] v(e)c[+5] v[100,50] v(e)c[+10]" 



Figure 5-3 



p[384,240] c[+100,+50] c[+3] 

p(b) [310,193] t'CURRENT POSITION' 

p[285,213] t' (START END POSITION)' 

p(e,b) [-40, +5] t' [384,240] ' 

p(e,b) [+100, +50] c[+3] p[+10] t' [+100 ,+50] ' 

p[300,390] t"p[384,240] c[+100,+50]" 



Figure 5-4 



l 



p[284,300] (b) c[+3] c(c) [+100,-100] 

p(e,b) [-90] f [284,300] ' 

p(e,b) [-150, +20] t'CURRENT POSITION" 

p(e,b) [-180, +40] t* (START END POSITION)' 

p(e) [+100,-100] c[+3] p[-50,-25] t' [+100 , -100] ' 

p[240,400] t"p[284,300] c(c) [+100,-100]" 



Figure 5-5 
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/ 



/; 

"' P 
P 
P 



Set defaults for text, writing commands' 
(dO,sl) w(v,pl) 

"Set current position, mark and label it, add text above and below it 1 
[384,240] ct+3] p (b) [-40 , -50] t'CURRENT' p( e ,b) [-40 , -30] f POSITION' 
(e,b) [+5,-12] f [384,240] ' 

(e,b) [-50, +10] f (START END* p(e ,b) [-40 ,+30] t'POSITION)' p(e) 
'Draw arc, mark and label endpoints' 

'Endpoint positions determined by temporarily embedding' 
'other commands including r(p)' 

(al40) [ + 100,-100] p[+100,-100] c[+3] p[ + 5,-5](b) t' [ + 100 ,-100] ' 
(e) [,+20] f ([489,135])' 
[242,253] c[+3] p[-85,+5] t' [242,253]' 
'Draw arc with pattern to show drawing direction,' 
'Leave gap for text 1 

[384,240] [+90,-90] w(p4) c (a70c) [384 , 240] w(p0) c (a20c) [384 , 240] 
(b) p[+5,-15] w(v) t'140 degrees' p(e) 
(p4) c(a50c) [384,240] p[384,240] p[+90 , -90] [ + 7 , -2] 
'Vs drawn at endpoints' 

(pi) t(d225.s0) 'V p[256, 251] [-5,-10] t(d0,sl)*V 
'Print basic command' 
[240,350] t'p[384,240] c (al40) [+100 , -100] ' 



Figure 5-6 



'Mark and label radius of arc, move to start of arc' 

[384,140] c[+3] p(b) [-40,-30] t (si) ' [-100 , -100] ' p(e) [ + 100 , +100] 

'Mark and label current position' 

[+3] p(b,b) [+5,-20] t'START POSITION' 

(e,b) [+5] t' (CURRENT POSITION)' p(e) 

'Draw ate' 

(a-90c) [-100,-100] 

'Mark and label end position' 

[+3] p(b) [-125,-20] t'END POSITION' p(e,b)[-125] t 1 (NEW CURRENT ' 

(e) [-125, +20] t'POSITION)' 

'Return to start and draw inner arc with gap for text' 

(e) [-10,-10] (b) [-2,-7] t(d-45,s0) *V w(p4) 

(e) c(a-28c) [384,140] w(e,p0) c (a-34c) [384 , 140] 

(v,pl) p(b) [+10,-20] t(d0,sl) '-90 ! p(e,b)[,-5] t'degrees' p(e) 

(p4) c(a-28c) [384,140] p[+5,-4] t (d-135 ,s0) ' V ' (dO , si) 

'Add command' 

(pi) p[300,350] t'c(a-90c) [-100,-100] ' 



Figure 5-7 



p[100,200] (b) c[+3] c(s) [] [370,50] [420,360] [120,390] [](e) 

p(e) [-90,-10] t' [100,200]' p[-50,+20] t'START POSITION' 

p[370,50] c[+3] p[+7,-20] t'[370,50]' 

p[420,360] c[+3] p[+5,+5] t'[420,360]' 

p[120,390] (b) c[+3] p[-90,-10] t' [120,390]' p ( e) [-50 , -30 ] 

t'END POSITION' p[100,430] 

fp[100,200] c(s)[] [370,50] [420,360] [120,390] [](e)' 



Figure 5-8 
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p[230,240] c[+5] c(b) [320,160] c[480,120] 

c[570,160] c [480,240] c[320,280] c(e) c[+10] 

p[230,240] (b) [-90,-10] t* [230,240]' 

p(e,b) [-90, +10] t'START' 

p(e) [-90, +30] t'POSITION* 

p[320,160] c[+3] p[-80,-20] t' [320 , 160] * 

p[480,120] (b) c[+3] p[,-30] f [480,120]' 

p(e)[,-50] t'END POSITION' 

p[570,160] c[+3] p[+5,-10] t' [570,160]' 

p[480,240] c[+3] p[+5,+5] t' [480,240]' 

p[320,280] c[+3] p[,+5] t' [320,280]' 

p[220,350]t(sl) 'p[230,240] c (b) [320 , 160] [480,120] 

[570,160] [480,240] [320,280] (e) ' 



Figure 5-9 



P[100,85] T[+32,+28] 'ABCD' 

P[200,255] T[-32,+44] 'ABCD' 

P [100,60 j T (SI) !! T[+3 6,+0] (S [32,60] ,M[4 ,6] ) 

P[100,235] T(S1) "T[+32,+28] 'ABCD' " 

P[100,450] T(S1) "T[-32,+44] 'ABCD'" 



Figure 5-1 1 



P [100,0] T[ + 36,+0] (S [32,60] ,M[7,10]) 'ABCD' 
P [100, 120] T [+36, +0 ] (S [32,60] ,M [1,2]) 'ABCD' 
P [100, 240] T[ + 36,+0] (S [32 , 60] ,M [4 , 6] ) 'ABCD' 
P[100,70] T(S1) "T[+36,+0] (S [32, 60] ,M [7 , 10] ) 'ABCD' 
P[100,190] T(S1) "T[+36,+0] (S[32,60] ,M[1,2]) 'ABCD' 
P[100,310] T(S1) "T[+36,+0] (S[32,60] ,M[4,6]) 'ABCD' 



Figure 5-13 



p[100,150] t(d45,s4) 'ABCD' 

p[100,200] t(d0,sl) 'p[100,100] t (d45, s4) ' ABCD' ' 

p[100,370] t(d45,s4,d0) 'ABCD' 

p[100,420] t(d0,sl) 'p[100,400] t (d45, s4,d0 ) ' ABCD' 

p[400,200] t(d-45,s4,d0) 'ABCD' 

p[400,400] t(d0,sl) 'p[400,200] t (d-45 , s4,d0 ) ' ABCD' 



Figure 5-15 
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; "FRAME. PIC" 

p[50,50] c(a-90) [0,50] 

w(v) p[ 50 , 0] v [717] c(a-90c) [717,50] 

v[,430] c(a-90c) [717,430] 

p[720,479] v[50] p[50] c(a-90c) [50 , 429] 

v[,50] p[717,50] w(e)v[] p[25,25] 

w(v)v[742] [,454] [25] [,25] 

; "WRMODE.PIC" 

; set ..up box drawing macrogra-ph 

@:av[+200] [,+200] [-200] [,-200]§; 

;'set up erase macrograph" 

@:ep[717,50]v(w(e,sl[,430]) ) [50] p[200 , 100] @; 

@e 

t(i0,s3)w(v,sl[,200]"/")?a 

p[200,100] 

p[+50,+50]w(sl"\")§a 

p[180, 400] t(s2) 'OVERLAY WRITING 1 

;'the next command waits 2 seconds, then prints display' 

«-/4-"ionur.»r-ir»r»->««-»i»i_»/»_ r J 

oii.i4u,inp L iuu ( juuj ) ,n^fe 

t(i0,s3)w(r,sl[,200]"/")@a 

p[200,100] 

p[+50,+50]w(sl"\")@a 

p[180, 400] t(s2) 'REPLACE WRITING' 

s(tl20,h(p[100,300]) ,h)@e 

t(i0,s3)w(v,sl [,200] )@a 
p[200,100] 

p[+50,+50]t(aO)w(c,sl"\ M )@a 
p[160,400] t(s2) 'COMPLEMENT WRITING* 
s(tl20,h(p[100,300]) ,h)@e 

t(i0,s3)w(v,sl[,200] "/")@a 

p[200,100] 

p[ + 50,+50]w(e,sl"\ , ')§aw(v) 

p[200, 400] t(s2) 'ERASE WRITING' 

s(tl20,h(p[100,300] ) ,h) (e) 

Figure 5-17 — Figure 5-20 



p[0,200] t(sl0) '12345678' 

p[0,0] v[767] [,479] [0] [,0] 

p[ 100, 100] v[ 484] [,340] [100] [,100] 

P[0,0] (b) [+5, +5] t(sl) ' [0,0] ' 

p(e) [+25, +25] 

v[95,95] p[-7,+2] t(d45sO)'V 

p[ 100, 100] [ + 5, +5] t(d0sl) 'S [100,100] ' 

p[767, 479] [-95,-25] f [767,511]' 

Figure 5-25 



GRAPHICS PRINTER 
CHARACTER PROCESSING 



GENERAL 

The DECwriter Graphic Printer's response to received characters de- 
pends on the printing mode selected. There are two basic printing modes- 
text mode and graphic mode. This appendix describes the graphic printer 
response to characters received while the printer is in graphic mode. Re- 

fer TO the near rtu'iries tr*, . :_x__ ,. 

„„,„„ iyjl yuui MIIMier Tor more complete information. 

GRAPHIC MODE 

While in text mode, characters are printed as they are received. In graph- 
ic mode, characters received define specific columns of dots to be print- 
ed. Graphic mode allows users to print dot combinations anywhere on a 
page^ This mode can be used to draw pictures and plot graphs (Figures I- 



EXPENDITURES 
BILLIONS OF DOLLARS 



PWLIC AW /KTIMTF SCHOOLS 



lUDI Enrol luent, total 
d3 Public Enrol l*ent 
■■ Private Enrollment 
Total Expenditures 



Right Scale 



Public Expenditures J — 
Private Expenditures — ' 



i960 1962 1964 1966 

Figure 1-1 Graph Example 
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Figure 1-2 Picture Example 

After entering graphic mode, both the horizontal and vertical pitch 
change. The right, left, and bottom margins also change. The graphic 
mode pitch and margins section describes these changes. DIGITAL does 
not recommend using single sheet or tractor feed paper when operating in 
graphic mode. 

The graphic printer has a horizontal resolution of 132 columns per inch 
with a 50 percent overlap, and a vertical resolution of 72 dots per inch 
with no overlap between dots. There is a 44 percent dot overlap between 
lines. The aspect ratio (ratio of horizontal to vertical resolution) is 1.83. 

GRAPHIC STRING FORMAT 

The format for a string of graphic data is as follows. 



DCS introducer 

Protocol selector 

Data 

DCS terminator 



ESC P 

Pn q 

Control characters or column definitions 

ESC\ 



DCS Introducer ; c 

When the graphic printer receives the DCS introducer, it enters DCS 
mode and waits for the correct protocol selector. The DCS introducer is 
the ANSI DCS introducer sequence ESC P (octal 033 120). 

When the protocol selector is received the graphic printer begins to pro- 
cess data as described in the data section. 

The graphic printer remains in DCS mode if f he proper protocol selector is 

_* : . i r, r ,4 +h* nronhir. nrinter receives a character that is out of 

range before the correct protocol selector is recognized. 
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PRINT HEAD 



TOP 




WIRE 
1 


BIT1 


O 




o 


2 


BIT 2 




o 


3 


BIT 3 




o 


4 


BIT 4 




o 


5 


BIT 5 




o 


6 


BIT 6 


BOTTOM 


o 


7 


NOT USED 






Figure I-3 Graphic Mode Printhead Firing 

NOTE: In DCS mode the DECwriter Graphic Printer discards all printable 
characters in the octal range 040 - 176 (Figure 1-3). All control characters 
received (octal 000 - 037) except CAN (cancel), SUB (substitute), and 
ESC (escape) are processed as described in the Received Character 
Processing chapter. 



Protocol Selector 

After receiving the DCS introducer, the protocol selector causes the 
graphic printer to enter graphic mode. The protocol selector for the graph- 
ic printer consists of a numeric parameter and a final character. The cor- 
rect protocol is zero (octal 060) or one (octal 061) and q (octal 161). 

Data 

The data contained within a graphic string can either be control charac- 
ters or printable data. The following paragraphs describe the control char- 
acters to which the graphic printer responds in graphic mode, and the for- 
mat of the printable characters received. 
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Control Characters 

In graphic mode, the graphic printer responds to a subset of the following 
control characters. 

• ANSI Control Characters 

Table 1-1 lists and describes the ANSI control characters in the 000 
to 037 octal range that are processed in graphic mode. 

• Private Control Characters 

Table 1-2 lists and describes the private control characters in the 
040 to 076 octal range that are processed in graphic mode. 

Printable Data 

After the proper protocoi selector is received, any character receive^ sn 
the 077 - 176 octal range is considered printable data. These characters 
define a column of six dots to be printed. This allows selective firing of the 
top six printhead wires (Figure I-3). The bottom or seventh printhead wire 
is not used in graphic mode. 

Printable characters are processed in the following way. The offset (octal 
077) is subtracted from the binary value of the character received. The 
result is a six dot column definition. A printhead wire is fired, and a dot 
printed, if the corresponding bit is set to one. 



Table 1-1 Graphic Mode ANSI Control Characters 

Octal 
Name Mnemonic Code Function 



Null 


NUL 


000 


No operation (not stored in the 
input buffer) - used as fill 
characters 


Bell 


BEL 


007 


Sounds audible bell tone 


Cancel 


CAN 


030 


Immediately causes an exit 
graphic mode 


Substitute 


SUB 


032 


Replaces any character receiv 



with errors - when received in 
graphic mode, SUB is processed 
as a one column space 

Escape ESC 033 Causes the DECwriter Graphic 

Printer to exit graphic mode 
and process the sequence 
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Table 1-2 Graphic Mode Private Control Characters 



Name 



nc 
repeat 
introducer 



Octal ASCII 
Mnemonic Code Character Function 



DECGRI 041 { 



Begin processing a 
repeat sequence 



)IC 

carnage 
return 



DECGCR 044 $ 



Graphic new 
line 



DECGNL 055 



The collected 
column definitions 
are printed, then 
carriage moves back 
to position where 
first character was 
printed after 
enfenng graphic 

m/-»Hra tlr'o ill/->iur* 

■"""Vl miu UIIUIIJ 

lines to be over 
printed 

The collected 
column definitions 
are printed and 
carriage moves back 
to first character 
printed after 
entering graphic 
mode, then paper is 
advanced 1/12 inch 
this allows 
printing of two 
consecutive lines 
of graphic data at 
the same horizontal 
position 



The least significant bit is associated with the top printhead wire (wire 
one). The sixth bit is associated with the second printhead wire from the 
bottom (wire six), and is the last wire that can be fired in graphic mode. 



Wire 




Bit 


Top 


1 


1 




2 


2 




3 


3 




4 


4 




5 


5 




6 


6 


Bottom 


7 


Not used 
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Table 1-3 Printable Character Examples 







Binary 






Octal 


Value 






(Minus 


Wires 


Character 


Value 


Offset) 


Fired 


? 


077 


00000000 




o 

••0. •.•;••:.' 
' ° ' 




o 
o 
o 








o d 


****> 


176 


00111111 


• 
• 
• 
• 



137 00100000 o 

o 
o 
o 
o 



Refer to Table I-3 for several printable character examples. Table I-4 con- 
tains a complete list of the printable characters and the corresponding 
dot columns. A printing action does not occur each time a dot column is 
received. The dot columns are printed when one of the following condi- 
tions occur. 

• Fourteen columns are received. 

• A paper motion command is received. 

• An exit graphic mode sequence is received. 



Repeat Sequence 

A repeat sequence allows the graphic printer to continually print a dot col- 
umn for a specified number. It has the same effect as receiving the dot 
column that many times. A repeat sequence is defined as follows. 
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Repeat introducer ! (octal 041) 

Numeric parameter Number of times to print the dot column 

Dot column Character in the 077 - 1 76 octal range 

The repeat sequence introducer is the private control character ! (octal 
041). 

The numeric parameter specifies the number of times to print the column 
definition that follows. The numeric parameter is a string of characters in 
the 060 - 071 octal range. If a numeric parameter is not specified, a value 
of zero is assumed for the numeric parameter, if the value specified is 
larger than the graphic printer limit for numeric parameters (65,535), the 
limit is assumed. All decimal digits are processed as part of the count. 

The dot column (a character in the 077 - 176 octal range) is printed as 
many times as specified by the numeric parameter count. All control char- 
acters received during a repeat sequence are processed as usual. For 
examnle, the control character ! resets the re°eat ss n usnc a <»nnn* 

All unspecified characters (octal 072 - 076) are ignored. 

If a repeat sequence with 14 or more blank column definitions is received, 
the graphic printer performs a graphic mode slew. During this condition, 
the printer moves the carriage assembly over the white space at 45 inch- 
es per second. The slew stops for the last 14 columns. 

DCS Terminator 

The DCS terminator ESC \ (octal 033 134) causes the graphic printer to 
exit graphic mode and revert to text mode character processing. The CAN 
(cancel) or ESC (escape) control characters also cause the graphic print- 
er to exit graphic mode. If the ESC control character is received, the 
graphic printer exits graphic mode and processes the escape sequence. 

After an exit condition, the graphic printer is set to the following condi- 
tions. 

• Text mode features (margins, pitch) are restored. 

• Vertical position is modified according to the control characters re- 
ceived while in graphic mode. 

• Horizontal position is the same as just before entering graphic mode. 

• The first text mode vertical motion command causes the graphic 
printer to advance to the next text mode line before executing the 
command (refer to vertical resynchronization). 

GRAPHIC MODE PITCH 

In graphic mode the horizontal pitch is set to 70 columns per inch (5 char- 
acters per inch). The vertical pitch is set to 1/12 lines per inch. 
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GRAPHIC MODE MARGINS 

If an attempt is made to print past the right margin set in text mode, the 
printer automatically generates a graphic new line (refer to the Private 
Control Character section in this chapter). 

Graphic mode maximum line length depends on the horizontal pitch and 
right margin selected in text mode. In graphic mode, the maximum line 
length is 13.1 inches (1,736 dots). To use the maximum line length, the 
following conditions must be met before entering graphic mode. 

• Horizontal pitch feature must be set to 10 characters per inch. 

• Text mode left margin must be set to column one. 

• Text mode right margin must be set to column 132. 

• Active coiumn must be column one. 

After entering graphic mode the left margin is repositioned to the right 
(0.11 inches maximum) of the last printed column in text mode. Graphic 
mode left margin is calculated in the following way. 

(Current Active Column - 1) X Old Pitch 

Left Margin = 1 + ■ 

70 

If there is a remainder, round up to the next whole number. 

After entering graphic mode the right margin is repositioned to the left of 
the text mode right margin (0.11 inches maximum). The graphic mode 
right margin is calculated in the following way. 

Old Right Margin X Old Pitch 

Right Margin = 

70 

Discard any remainder. 

The top margin remains the same as in text mode. The bottom margin is 
calculated in the following way. 

Old Bottom Margin X Old Pitch 

Bottom Margin = 

1/12 

Perforation Skip 

When using perforated paper in graphic mode, it may not be desirable to 
print on the perforations between sheets of paper. If you are using friction 
feed roll paper, continuous printing is allowed. 
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The printer distinguishes between a perforated form and a continuous 
form in the following way. 

• If the top margin equals one and the bottom margin equals the form 
length, the printer ignores the bottom margin and continues to print 
data (continuous form). 



• 



If the top margin does not equal one or the bottom margin does not 
equal the form length, the printer does not print below the bottom 
margin and skips to the next top margin (perforated form). 

Vertical Resynchronization 

In text mode lines are spaced according to the vertical pitch selected. In 
graphic mode lines are spaced 1/12 inch apart. Because of the difference 
in vertical pitch, the printhead may not be on a text mode line when the 
printer exits graphic mode. The printer must resynchronize the printhead 
to the next text mode line. This resynchronization occurs during the fol- 
lowing conditions. 

• A perforation skip 

• After exiting graphic mode, just before the first vertical motion such 
as a form feed or line feed (except superscript and subscript) 

Superscript or subscript can be used to label grahic data with text mode 
comments. Reverse line feed is not recommended because the vertical 
registration of graphic data may not be satisfactory. 

Table I-4 contains the graphic mode printable characters, and the dot col- 
umn definitions for each character. 

Table 1-4 Printable Character Dot Column Definitions 
(Graphic Mode) 

Octal Wires Octal Wires 

Character Value Fired Character Value Fired 



SI 



lllBfll@llllllllllillli^llllllllllllllllllli 



• = dot o = no dot 
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Table 1-4 Printable Character Dot Column Definitions 
(Graphic Mode) (Cont) 



Character 



Octal Wires 
Value Fired 



103 





Octal 


Wires 


Character 


Value 


Fired 


vs^P- 


111 


o 

■■■ • 
o 

o 



D 



104 



112 



105 



K 



113 



106 



114 



G 



107 



M 



115 



H 



110 



N 



116 



• = dot o=nodot 
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Table 1-4 Printable Character Dot Column Definitions 
(Graphic Mode) (Cont) 



Character 



O 



Q 



Octal 


Wires 


Value 


Fired 


117 


; " '- o." 




i' • ° V 




-.'O.V.'. 









• 




o 


120 


• 














o 




• 







121 







• 




o 








Character 



Octal 
Value 

126 



W 



127 



130 



Wires 
Fired 



R 



122 



131 



123 



132 



124 



133 



U 



125 



134 
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Table 1-4 Printable Character Dot Column Definitions 
(Graphic Mode) (Cont) 



Character 



Octal 


Wires 




Octal 


Wires 


Value 


Fired 


Character 


Value 


Fired 


135 


• 
• 
• 
• 


^^^^^^^^B. 


143 




• 



• 


136 


• 
• 

• 
• 
• 


^^^^^^M 


144 


• 

IHillll 
• 

• 


137 


^B^^^^^^B 


145 


^^^^J 




^^^^^^ 






• 




^^^^^^B 






• 




^S^^^^B 











• 






o 

• 



140 • f 146 • 

142 • h 150 • 



• = dot o = no dot 
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Table 1-4 Printable Character Dot Column Definitions 
(Graphic Mode) (Cont) 



Character 



Octal Wires 
Value Fired 



Octal Wires 
Character Value Fired 



151 



160 



152 



161 



153 



162 



154 



163 



m 



155 



164 



156 



165 



157 



166 
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Table f-4 Printable Character Dot Column Definitions 
(Graphic Mode) (Cont) 





Octal 


Wires 




Octal 


Wires 


Charact 


er Value 


Fired 


Character 


Value 


Fired 








f 


173 




w 


167 





•;-'0:;: : :■';'.: 


' ; '';■,'■'.■ ■':'" 











o 






o 






v #: ;•:.•• 






: ■ *-\--:-"-': ■-■'■': ■ 






.•;;••'.;'';;:.;> 






• 








x : ■ 


170 


o 



• 


\ l: ; / 


174 


o 

• : 



171 



172 



175 



176 



• = dot o=nodot 



GLOSSARY 



Active position 



This is the character position on the visual 
display that displays the next graphic 
character. 



ANSI mode 



This VT100 mode recognizes and responds 
only to escape sequences whose syntax and 
semantics comply with ANSi specifications. 
The graphics processor always is in ANSI 
mode. 



Character position 



This is the part of the visual display that can 
display a graphic symbol. 



Control 



This is a control character, escape 
sequence, or control sequence that performs 
a control function. 



Control character 



This character can initiate, modify, or stop a 
control function. 



Control function 



This action affects the recording, processing, 
transmission, or interpretation of data. 



Control sequence 



This sequence of characters is used to 
perform a control function. It begins with the 
control sequence introducer (CSI) control 
and may contain a parameter string. 



Control sequence 



This escape sequence provides 
supplementary introducer (CSI) controls and 
is itself a prefix affecting the interpretation of 
a limited number of contiguous characters. 



Control string 



This string of characters performs a control 
function and is delimited by an opening and 
closing delimiter control. 
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Cursor 

Cursor control 
Default 

Display 

Escape character 



Escape sequence 



Final character 



Graphic character 



Graphic object 



HLS 



Home 



Intermediate 



This blinking reverse-video or underline 
represents the active position. 

This function moves the active position. 

This function-dependent value is assumed 
when no value, or a value of 0, is specified. 

This active area of the screen inside the 
scrolling region, or the entire screen, 
depending on the origin mode. 

This control character provides (ESC) 
supplementary characters (code extension) 
and is itself a prefix affecting the 
interpretation of a limited number of 
contiguous characters. 

This sequence of characters is used to 
perform a control function, the first character 
of which is the escape (ESC) control 
character. 

The bit combination of this character 
terminates an escape or control sequence 
designated by F. 

This is a character, other than a control 
character, that has a visual representation 
normally handwritten, printed, or displayed. 

This is a geometric shape that can be 
described with a few characters of 
information. 

Hue, Lightness, Saturation - This is A three 
parameter system for describing a color on a 
video monitor. 

This is the character position at the origin. 
[See origin mode (DECOM)]. 

The bit combination of this character 
precedes character a final character in an 
escape or control sequence. 
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Macrograph 



In ReGIS, this is any series of sequential 
commands stored in the terminal's memory 
and performed (invoked) on request by two 
characters. Macrographs reduce 
communication line traffic between the 
terminal and the computer when the same 
commands are used again and again. 



Numeric parameter 



This string of bit combinations represents a 
number, designated by Pn or Ps. 



Parameter 



Parameter can have two meanings. 



1 . It is a string of one or more characters 
that represents a single value. 

2. It is the value so represented. 



Parameter string 



This string of characters represents one or 
more parameter values. 



Pixel 



Protocol 



ReGIS 



This is the smallest unit of information on a 
graphics display. 

These are the conventions or rules for the 
format and timing of messages sent and 
received. Devices must be using the same 
protocol to understand each other. 

Remote Graphics Instruction Set - This is a 
set of graphics object description commands. 



Selective parameter 



This string of bit combinations selects a 
subfunction from a specified list of 
subfunctions, designated by Ps. In general, a 
control sequence with more than one 
selective parameter causes the same effect 
as several control sequences, each with one 
selective parameter. For example, CSI Psa; 
Psb; Psc F is identical to CSI Psa F CSI Psb F 
CSIPscF. 



VT52 mode 



This VT100 mode recognizes and responds 
only to escape sequences that DIGITAL VT52 
type terminals use. The graphics processor 
does not have VT52 mode. 



OTHER TERMINALS 



GENERAL 

The terminal is a vital link between the user and the power of the com- 
puter. Often the right terminal, or the right enhancement to your terminal, 
can make work easier, more efficient, or more cost effective. For that rea= 
son, DIGITAL offers a full range of video and printer terminals and options 
that can heip you with any application. 

PRINTER TERMINALS 

DIGITAL'S printer terminals are noted for their strength and reliability, sel- 
ectable baud rates, and multiple user-selectable features, that provide the 
flexibility you need to efficiently configure your workstations. 

DECwriter III 

DIGITAL'S LA120 DECwriter III is the performance terminal for high-speed 
communications. At 180 characters per second, the DECwriter III boosts 
throughput by combining bidirectional smart printing and a 100-character 
buffer with fast horizontal and vertical skipping over white space. The 
LA120 also offers the convenience and flexibility of more than 45 key- 
board-selectable features. These features include variable font sizes, 
tabs, form lengths, and many other time-saving features previously avail- 
able only as options. Mnemonic commands, prompting LED display, a 
special decal, and a convenient pocket-sized operator card all make the 
LA 120 easy to set up and use. 

A selectable baud rate (up to 9600) along with automatic self-test diag- 
nostics give you the performance and reliability you look for in a high- 
speed communications terminal. 
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DECwriter IV 

DIGITAL continues to develop new technology and better terminals with 
functional specifications our customers demand. The new DECwriter IV is 
the latest in small convenient printers. It comes in two models, both light 
and compact enough to be easily transported to the most convenient 
workstation for maximum efficiency. The LA34 is the desk-top model with 
designer appearance and typewriter-like keyboard. It is smaller, lighter, 
and quieter than many typewriters. The easy-to-change ribbon cartridge, 
roll-free paper, and convenient keyboard-selectable features - like four 
character-width adjustments - make this terminal simple enough for any- 
one to use. 

The LA38 comes with tractor feed for multipart forms and includes roll 
feed for standard paper. A numeric keypad is standard for fast input of 
accounting data. 

The DECwriter IV terminals include standard features such as micro- 
processor control, true 30 characters per second throughput, up to 9600 
baud rate, and DECwriter reliability. These features give you all the per- 
formance you need in a convenient size package. 

DECwriter IV Graphic Printer 

DECwriter IV Graphic Printers are receive-only (RO) microprocessor-con- 
troller, low-cost, desk-top printers. They use an impact dot matrix printing 
technique for character representation. DECwriter IV Graphic Printers op- 
erate in one of two printing modes, text or graphic. In text mode, charac- 
ters are printed as they are received. In graphic mode, received charac- 
ters define columns of printed dots. 

The printer can be used as an output device for a computer or word pro- 
cessor so that characters received from the computer are printed. The 
graphic printer can also be used as the output device for a graphic termi- 
nal such as the VT125 or the VK100. 

VIDEO TERMINALS 

DIGITAL'S video display terminals offer unmatched convenience and ca- 
pabilities with features designed to give you performance you would ex- 
pect from much more expensive and complex equipment. 
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VT100 

For the ultimate in video terminals, look to DIGITAL'S VT100. It combines 
exceptional versatility with simplicity of operation. It's designed to allow a 
wide range of fast and easy field upgrades to meet your changing needs. 
There is a detached typewriter-style keyboard with a flexible, 3-wire 
coiled cord. An 18-key numeric/function keypad on the keyboard permits 
single keystroke control of application-specific functions. The VT100 fits 
easily on a standard typewriter table. There is an advanced video option 
that provides 132-column lines of the screen for easy viewing of wide-line 
printer reports. Double-height/double-width characters are selectable line 
by line for easier reading and text formatting. Smooth scrolling a scan at a 
time lets your operators read new lines at a reasonable speed. Divided- 
screen displays; blinking, underlining, double intensity and normal or re- 
verse video character attributes; keyboard and /or computer-settable tab 
stops; built-in, self-test diagnostics; pictorial capability; and many, many 
more features are available. 
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Absolute position in ReGIS, 97, 101 
Accessories, 243 
Address Space, 144 
Arjiystments 81 
Alternate keypad mode 

(see keypad application mode), 54 
Alternate ROM character sets 
(see character sets 
and selection), 57 
ANSI-compatible sequences, 45 
ANSI/VT52 

Feature, 27 

Mode, 51 
Answerback message, 31 
Arcs 

(see curves), 110 
Argument in ReGIS, 96 
Attributes 

Character, 64 

Device, 77 

Line, 70 
Audible indicators 

Bell tone, 11 

Keyclick, 1 1 

Series of bell tones, 1 2 
Auto new line at margin 

(see auto wrap), 27,51 
Auto (key) repeat 

Feature, 26 

Mode, 51 
Auto wrap 

Feature, 27 

Mode, 51 
AutoXON/XOFF, 27 



Auxiliary port on /off 

(see media copy), 75 
Axis (coordinates), 143 



B 



Background (screen) 

Feature, 26 

Mode, 55 
Backspace key, 6, 38 
Baud rate 

Auxiliary port 
transmit /receive speed, 29 

Computer port receive speed, 30 

Computer port transmit speed, 30 
Bell, 3,12,44 
Bits 

Auxiliary port character length, 29 

Computer port character length, 29 

Stop, 189,253 
Bits per character, 29, 189 
Blink attribute, 63 

Block cursor (see cursor feature), 27 
Block diagrams, 194 
Bold attribute, 63 
Bottom margin 

(see set top and bottom margin), 65 
Bounded Sequence of coordinates 

Position command, 103 

Vector command, 107 
Brackets in ReGIS, 96 
Break 

BREAK key, 7,31,36 

Break signal, 190 
Brightness 

(see screen brightness), 22 
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Buffer overflows 

(see auto XON/XOFF), 27,199 



Cables, 193,243 
CAPS LOCK key, 5, 35 
Character 

Attributes, 63 

Sets, 57 
Character bits 

Auxiliary port character length, 29 

Computer port character length, 29 
Character Cell Controls, 155 

Associate Name, 155 

Command Summary Table, 155 

Load Character Cell, 155 

Select Character Set for Loading, 1 55 
Characters 

Control, 44 

Display, 44 

Fill, 199 

Received, 41 

Serial, 189 

Transmitted, 35 
Characters per line 

(see columns per line), 22, 52 
Checkout procedure 

Advanced video option, 230 

Graphics processor, 208 

Terminal, 208 

20 mA option, 227 
Check parity 

(see receive parity), 29 
Circles 

(see curves), 110 
CLEAR ALL TABS key, 8, 24 
Click (see keyclick), 11,27 
Closed Curves 

(see curves), 110 
Color 

(seeHLS), 133, 146, 147, 291 
Column mode, 52 
Columns per line, 22, 52 
Comma in ReGIS, 97, 98 
Communication 

Cables, 

Connector, 188, 191 

Paths, 194 



Compatibility 

ANSI sequences, 45 

VT52 sequences, 86 
Connecting to the computer, 187 
Contrast 

(see screen brightness feature), 22 
Control character 

Description, 44 

in ReGIS, 98 

Keys, 37 
Controls 

Keyboard, 4 

Monitor, 2 
Controls 

Screen, 142 

Writing, 127 
Control sequences, 41, 277 
Coordinates, 97, 100, 143 
CPR (cursor position report), 77 
CTRL key, 6 

CUB (cursor backward), 67 
CUD (cursor down), 67 
CUF (cursor forward), 67 
CPU (cursor position), 67 
Current loop 

Option, 223 

Switches, 226 
Current position, 99 
Cursor 

Addressing, 67 

Backward (left), 67 

Down, 67 

Feature, 27 

Forward (right), 67 

Graphic, 99 

Key mode, 53 

Keys, 7, 37 

Position, 67 

Positioning, 67 

Position report, 77 

Text, 27 

To home, 67 

Up, 67 
Curves, 110 

Arcs, 112 

Command summary table, 117,274 

Circles, 1 1 1 

Closed (Bounded) Curves, 1 15 

Interpolation, 113 

Open (Unbounded) Curves, 1 14 
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Custom Writing Control, 
CCU (cursor up), 67 



138 



DA (device attributes), 77 

Dark screen (see screen background), 26, 

55 
Data loopback self-test 

Auxiliary port, 217 

Computer port, 216 

VT 100 tests, 81 
Data /parity 

Auxiliary port, 27 

Computer port, 27 
DECALN (screen alignment display), 81 
DECANM (ANSI / VT52 compatibility), 5 1 
DECARM (auto repeat mode), 51 
DE\_»r\»Vm yauiO wrap moclG/, 5 i 
DECCKM (cursor key mode), 53 
DECCOLM (column mode), 52 
DECDHL (double-height line), 70 
DECDWL (double-width line), 70 
DECID (identify terminal), 78 
DECKPAM (keypad application mode), 54 
DECKPNM (keypad numeric mode), 55 
DECOM (origin mode), 55 
DECRC (restore cursor), 68 
DECSC (save cursor), 68 
DECSCLM (scroll mode), 56 
DECSNM (screen mode), 55 
DECSTBM (set top and bottom 

margins), 65 
DECSWL (single-width line), 70 
DECTST (invoke confidence test), 81 
DECwriter graphics destination 

(see media copy), 76 
Default 

Memory, 16 

Origin, 100 

ReGIS Position, 97, 100 

ReGIS Screen, 142 

ReGIS Text, 118 

Regis Writing, 127 
Delete key, 6, 38 
Device attributes, 77 
Device Control String, 73, 96 
Device status report, 77 
Dimensions, 251 
Direct Cursor Address, 67 



Displayable characters, 44 

Documentation, 243 

Dot at current position, 106 

Double-height line, 70 

Double-width line, 70 

DSR (device status report), 79 



ED (erase in display), 71 
EIA, 187 
80/132 columns 

Columns per line, 22, 52 

Keys, 9 
EL (erase in line), 72 
End a sequence of coordinates, 103 
Endpoints, 114 

DECwriter, 74 

ReGIS, 73 

VT52 mode, 88 

VT 100 special, 57 

VT105 emulation, 75 
Enter key, 39 
Enter keypad application 

(alternate) mode, 54 
Erase in display, 71 
Erase in line, 72 
Erase in ReGIS, 145 
Erase to end of line, 72 
Erase to end of screen, 7 1 
Erasing, 71 

Error recovery (sequence), 41 
ESC key, 6, 38 
Escape sequences, 41,277 
Exit graphics 

DECwriter, 75 

ReGIS, 75 

VT52 mode, 88 

VT100 special, 57 

VT105 emulation, 75 
Exit keypad application (alternate) mode 
(enter numeric mode), 55 
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Features 

Descriptions, 21 

General features, 21 

SET-UP A, 16 

SET-UP B, 16 
Feature memories 

Default, 20 

Operating, 18 

User, 18 
Feature types 

Communication compatibility, 13 

Installation, 13 

Operator preference, 13 
Figures, ReGIS command listings, 295 
Fill characters, 199 
Floating point in ReGIS, 99 
Foreground Intensity and Color, 133 
Full-Duplex, 190 
Function keys, 36 
Fuse, 252 



Identify, 77 
Identify terminal, 77 
Ignore parity 

(see receive parity feature), 29 
Illustrations, ReGIS command listings, 295 
IND (index), 68 
Index, 68 
Indicators 

Audible, 1 1 

Keyboard, 10 
Input buffer overflows 

(see auto XON/XOFF feature), 27, 
199 
Installation 

Advanced video option, 229 

Graphics processor, 231 

Terminal, 203 

20 mA option, 223 
Internal communication switches 

on STP board, 241 
Interpolation of curves, 1 13 
Invoke confidence test, 81 



General default, 20 

General SET-UP features, 2 1 

Glossary, 313 

Graphics mode (see VT52 character 

sets), 88 
Graphic Object, 95 
Graphics printer character 

processing, 299 
Graphics Protocol, 76, 96, 97 



H 



Hardcopy 

Cancelling, 146 

Descriptor, 76 

Screen Command, 146 

SET-UP and, 146 
HLS, 133, 146, 147,291 
Home position (see origin mode), 55 
Horizontal tabulation set, 69 
Horizontal and vertical position, 67 
HTS (see horizontal tab set), 69 
Hue, Lightness, Saturation 

(see HLS), 133, 146, 147, 291 
HVP (see horizontal and 
vertical position), 67 



Jump scroll 

Scroll mode, 56 

SET-UP feature (see scroll), 



K 



25 



KBD Locked 

(see keyboard locked indicator), 10 
Keyboard controls, 4 
Keyboard (keys), 4 

Function, 6 

SET-UP, 8 

Standard, 5 
Keyboard indicators, 10 
Keyboard locked indicator, 10 
Keyclick feature, 27 
Keyletter ReGIS command, 96 
Keypad application mode, 54 
Keypad key codes, 39, 54, 87 
Keypad numeric mode, 55 
Key repeat (see auto repeat), 26,51 
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N 



217 
216 



LA34-VA Hardcopy descriptor, 76 
Light screen 

(see screen background), 26, 55 
Line Attributes, 70 
Linefeed /new line 

Feature, 28 

Mode, 53 
Linefeed key, 7, 38 
LNM (see linefeed /new line mode), 53 
Local 

Description, 9, 194 

Feature, 21 

Indicator, 10 

Key, 9 
Loopback connector specifications, 256 

i_u<JjJUcior\ ociricoio 

Auxiliary port data loopback, 
Computer port data loopback, 
Display, 218 
Error codes, 220 
Power-up, 215 
Preparation, 213 
Sequences, 83 
Video bit map memory, 2 1 9 
VT 100 tests, 81 



M 



Macrographs, 153 

Command Summary Table, 154, 275 

Reports, 157 
Maintenance, 211 
Margin 

Margin bell, 27 

Set top and bottom margins, 65 
Media copy 

Auxiliary port on /off, 75 

DECwriter graphics destination, 76 

Screen on /off, 76 
Memories, 16,96 
Modem, 187 
Modes 

ANSI mode selection, 51 

ANSI (SET-UP features 
and mode selection), 27 

ReGIS writing modes, 127 

VT52 mode selection, 51 



NEL (next line), 68 

New line (see linefeed /new line), 53 

Next line, 68 

NO SCROLL key, 7 

# /L key (see US /UK character set), 

Numeric keypad 

Keys, 39, 87 

Mode, 54, 87 
NVR (nonvolatile memory) 

(see user permanent memory), 



Odd-Y Simulation, 105,143 
One or two stop bits, 1 89, 253 

Description, 9 

Feature, 21 

Indicator, 10 
Open Curves 

(see curves), 110 
Operating information, 1 
Operating memory, 18 
Options 

Checkout, 223 

in ReGIS, 96 

Installation, 223 
Ordering information, 248 
Order of performance, 98 
Origin mode, 55 
Output Map, 131, 147 



Parentheses in ReGIS, 96 

Parity, 29, 189 

Patterns, 136 

Select Standard Pattern, 136 
Set Pattern Multiplier, 138 
Specify Binary Pattern, 137 

Pixel 

Definition, 95, 105 
Multiplier (see vector length 

multiplier), 102, 133 
Spacing, 100 
Vectors, 96,97, 101, 107 

Planes, 130 

Point specifier, 97 



57 



18 
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Position 

Absolute, 101 

Command summary table, 104, 274 

Defined, 97, 100 

Null, 101 

Relative, 101 
Power 

Feature, 29 

Power switch, 2 
Power-up and checkout procedure, 208 
Power-up self-test, 208, 2 1 3, 2 1 5 
Printing in ReGIS (see hardcopy), 146 



RETURN key, 6, 38 
Reverse 

Index, 68 

Linefeed, 90 

Screen (see screen background), 26, 55 

Video, 26, 55, 63 
RGB, 147 

Rl (reverse index), 68 
RIS (reset to initial state), 80 
ROM (see character sets and 

selection), 57 
RM (reset mode), 48 



Quotes in ReGIS, 96, 97, 117 



Read only memory (see character sets 

and selection), 57 
Recall, 19 

Received characters, 41 
Receive parity, 29 
Receive speed 

Auxiliary port transmit /receive speed, 29 
Computer port receive speed, 30 
RECEIVE SPEED key, 9, 30 
ReGIS 

Command, 96 

Definition, 95 
Syntax, 96 

VK100 compatibility, 287 

VT125, 95 
Relative position in ReGIS, 97, 101 
Repeat (see auto repeat), 26,51 
Reports, ANSI, 77 
Reports, ReGIS, 157 

Character Set Selected for 
Loading, 157 

Command Summary Table, 158 

Contents of a Macrograph, 157 

Cursor Position, 158 

Use of Macrograph storage, 158 
Reports, VT52, 92 
Reset, 20 
RESET key, 9 
Reset mode, 48 
Reset to initial state, 80 
Restore cursor, 68 



Save (see store) 

Command Strings 
(see macrograph), 153 

Cursor position, 68 

Feature, 19 

Macrograph, 153 

SET-UP Key, 19 

Text Options, 125 
Save cursor, 68 
Scientific Notation 

(see floating point), 99 
Screen alignment display, 81 
Screen background 

Feature, 26 

Mode, 55 
Screen brightness 

Feature, 22 

Keys, 10 
Screen Controls, 142 

Background definition, 146 

Command Summary Table, 152, 275 

Defaults, 142 

Display Addressing Definition, 143 

Erase, 145 

Hardcopy Output, 146 

Output Map Definition, 147 

Scale, 151 

Scrolling, 142 

Time Delay, 151 
Screen mode, 55 

Screen on /off (see media copy), 76 
Screen width (see columns per line), 22, 

52 
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Scroll feature 

Jump, 25, 56 

Scroll mode, 56 

Smooth, 25, 56 
Scrolling region, 65 
SCS (see select character set), 
Select character set, 57 
Select graphic rendition, 63 
Selecting features, 13 
Select Text Character Set, 1 25 
Self-tests 

Auxiliary port data loopback, 2 1 7 

Computer port data loopback, 216 

Display, 218 

Error codes, 220 

Power-up, 215 

Preparation, 213 



oe^uences, 



219 



Video bit map memory, 

VT 100 tests, 81 
Semicolon in ReGIS, 98, 99 
Sequences 

ANSI, 41 

Escape and control, 41,277 

VT52, 86 
Serial characters, 189 
Serial interface, 187 
SET/CLEARTABkey, 8 
Set mode, 48 
Set top and bottom margins 

(see scrolling region), 65 
SET-UP, 13 
SET-UP A, 16 
SETUP A/B key, 9 
SET-UP B, 16 
SET-UP features 

(see feature descriptions), 13 
SET-UP features and modes, 13 
SET-UP key, 8 
SET-UP memories (see feature 

memories), 16 
SGR (see select graphic rendition), 
Shading, 134 

Character, 134 

Reference line, 135 
SHIFT key, 5 
Single shift, 2, 63 
Single shift, 3, 63 
Single width line, 70 
Site considerations, 203 



SM (see set mode), 48 
Smooth scroll 
Scroll mode, 56 
SET-UP feature (see scroll), 25 
Special character and line drawing set 
(see character sets 
and selection), 57 
Special graphics (see character sets 

and selection), 57 
Specifications, 251 
Speed 
Auxiliary port 

transmit /receive speed, 29 
Computer port receive speed, 30 
Computer port transmit speed, 30 

552 (see single shift 2), 63 

553 (see single shift 3), 63 

uianuaiu rv^jro, *-», w-» 

Stop bits (see one or 

two stop bits), 189,253 
Store 

Command Strings 

See Macrograph, 153 

Cursor position, 68 

Feature, 19 

SET-UP Key, 19 

Macrograph, 153 

Text Options, 125 
String Terminator, 73, 96 
Supplies, 243 
Subscripts, 121 
Superscripts, 121 
Switches 

STP board, 241 

20 mA option, 225 



Tab 

Clear, 69 

Default, 20 
63 Key, 6 

Set, 69 

SET-UP keys, 8 

Stops, 69 
TBC (see tabulation clear), 69 
Temporary options in ReGIS, 99 

Temporary Pixel Vector Multiplier, 
102, 108, 116, 126 

Temporary Text Attributes Block, 1 25 
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Terminal 

Dimensions, 251 

Operation, 1 
Tests (see self-tests) 

Auxiliary port data loopback, 217 

Computer port data loopback, 216 

Display, 218 

Error codes, 220 

Power-up, 215 

Preparation, 213 

Sequences, 83 

Video bit map memory, 219 

VT 100 tests, 81 
Text, 117 

Character Cell Size, 118 

Character Height Multiplier, 120 

Character Spacing, 120 

Character Tilt Direction, 123 

Command Defaults, 118 

Command summary table, 126, 274 

Control characters, 118 

Italic Tilt, 124 

Options, 125 

Overstrike, 118, 121 

Pixel Multiplier, 122 

Pixel Vector Spacing, 1 2 1 

Quotes. 117 

Quoted String, 117 

Select Character Set, 125 

Temporary Writing Controls, 126 
TOGGLE 0/1 key, 9 
Top margin (see set top and 

bottom margins), 65 
Transmit 

Auxiliary port 
transmit /receive speed, 29 

Buffers, 201 

Computer port transmit speed, 30 

TRANSMIT SPEED key, 9, 30 
Transmitted characters, 35 
Troubleshooting, 211 
Truncation of numbers in ReGIS, 99 
20 mA option, 223 
20 mA switches, 225 
20 mA switch selection 

(see option installation), 225 
Two or one stop bits, 189,253 



U 



Unbounded sequence of coordinates 

Position command, 103 

Vector command, 108 
Underline 

Attribute, 63 

Cursor (see cursor), 27 
Unpacking and inspection, 205 

User memory, 16 
US/UK Character sets, 27,57 



Vector command, 106 

Command summary table, 109, 274 

Length multiplier, 133 
Voltage selection switch, 3, 205 
VT52 

Feature, 27 

Mode, 51 
VT52 compatible sequences, 86 
VT105 Emulation, 159 



W 



Winrlnw QR 1/19 

Wrap Address formulas, 145 
Wraparound (see auto wrap), 27, 51 
Writing Controls, 127 
Command Summary Table, 141, 274 
Custom Writing Control Definition, 138 
Defaults, 127 
Foreground planes, 130 
Modes, 127 

Complement, 127 

Erase, 128 

Overlay, 130 

Replace, 128 
Negative writing, 133 
Patterns, 136 

Pixel Vector Length Multiplier, 133 
Shading, 134 

Character, 134 

Reference Line, 135 



XON/XOFF feature (see auto 
XON/XOFF), 27 
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